Bagikan melalui

Struktur SOUNDSENTRYA (winuser.h)

  • Artikel

Berisi informasi tentang fitur aksesibilitas SoundSentry. Saat fitur SoundSentry aktif, komputer menampilkan indikasi visual hanya saat suara dihasilkan.

Windows 95/98: Indikasi visual ditampilkan saat suara dihasilkan melalui speaker internal komputer.

Windows NT/2000: Indikasi visual ditampilkan saat suara dihasilkan melalui layanan suara multimedia atau melalui speaker komputer.

Sintaksis

typedef struct tagSOUNDSENTRYA {
  UINT  cbSize;
  DWORD dwFlags;
  DWORD iFSTextEffect;
  DWORD iFSTextEffectMSec;
  DWORD iFSTextEffectColorBits;
  DWORD iFSGrafEffect;
  DWORD iFSGrafEffectMSec;
  DWORD iFSGrafEffectColor;
  DWORD iWindowsEffect;
  DWORD iWindowsEffectMSec;
  LPSTR lpszWindowsEffectDLL;
  DWORD iWindowsEffectOrdinal;
} SOUNDSENTRYA, *LPSOUNDSENTRYA;

Anggota

cbSize

Jenis: UINT

Menentukan ukuran, dalam byte, dari struktur ini.

dwFlags

Jenis: DWORD

Sekumpulan bendera bit yang menentukan properti fitur SoundSentry. Nilai bendera bit berikut didefinisikan:

Nilai Arti
SSF_AVAILABLE
0x00000002
 Jika bendera ini diatur, fitur SoundSentry tersedia.
SSF_INDICATOR
0x00000004
 Bendera ini tidak diimplementasikan.
SSF_SOUNDSENTRYON
0x00000001
 Jika bendera ini diatur, fitur SoundSentry aktif.

iFSTextEffect

Jenis: DWORD

Windows 95/98: Menentukan sinyal visual yang akan disajikan saat aplikasi mode teks menghasilkan suara saat berjalan di komputer virtual layar penuh. Anggota ini bisa menjadi salah satu nilai berikut:

Nilai Arti
SSTF_BORDER
2
 Flash batas layar (yaitu, area overscan), yang tidak tersedia pada beberapa tampilan.
SSTF_CHARS
1
 Karakter lampu kilat di sudut layar.
SSTF_DISPLAY
3
 Flash seluruh tampilan.
SSTF_NONE
0
 Tidak ada sinyal visual
 

Windows NT/2000: Anggota ini dicadangkan untuk digunakan di masa mendatang. Ini harus diatur ke nol.

iFSTextEffectMSec

Jenis: DWORD

Windows 95/98: Menentukan durasi, dalam milidetik, dari sinyal visual yang ditampilkan saat aplikasi mode teks layar penuh menghasilkan suara.

Windows NT/2000: Anggota ini dicadangkan untuk digunakan di masa mendatang. Ini harus diatur ke nol.

iFSTextEffectColorBits

Jenis: DWORD

Windows 95/98: Menentukan nilai RGB warna yang akan digunakan saat menampilkan sinyal visual yang ditampilkan saat aplikasi mode teks layar penuh menghasilkan suara.

Windows NT/2000: Anggota ini dicadangkan untuk digunakan di masa mendatang. Ini harus diatur ke nol.

iFSGrafEffect

Jenis: DWORD

Windows 95/98: Menentukan sinyal visual yang akan disajikan saat aplikasi mode grafis menghasilkan suara saat berjalan di komputer virtual layar penuh. Anggota ini bisa menjadi salah satu nilai berikut:

Nilai Arti
SSGF_DISPLAY
3
 Flash seluruh tampilan.
SSGF_NONE
0
 Tidak ada sinyal visual.
 

Windows NT/2000: Anggota ini dicadangkan untuk digunakan di masa mendatang. Ini harus diatur ke nol.

iFSGrafEffectMSec

Jenis: DWORD

Windows 95/98: Menentukan durasi, dalam milidetik, dari sinyal visual yang ditampilkan saat aplikasi mode grafis layar penuh menghasilkan suara.

Windows NT/2000: Anggota ini dicadangkan untuk digunakan di masa mendatang. Ini harus diatur ke nol.

iFSGrafEffectColor

Jenis: DWORD

Windows 95/98: Menentukan nilai RGB warna yang akan digunakan saat menampilkan sinyal visual yang ditampilkan saat aplikasi mode grafis layar penuh menghasilkan suara.

Windows NT/2000: Anggota ini dicadangkan untuk digunakan di masa mendatang. Ini harus diatur ke nol.

iWindowsEffect

Jenis: DWORD

Menentukan sinyal visual untuk ditampilkan saat suara dihasilkan oleh aplikasi berbasis Windows atau aplikasi MS-DOS yang berjalan di jendela. Anggota ini bisa menjadi salah satu nilai berikut:

Nilai Arti
SSWF_CUSTOM
4
 Gunakan sinyal visual kustom.
SSWF_DISPLAY
3
 Flash seluruh tampilan.
SSWF_NONE
0
 Tidak ada sinyal visual.
SSWF_TITLE
1
 Flash bilah judul jendela aktif.
SSWF_WINDOW
2
 Flash jendela aktif.

iWindowsEffectMSec

Jenis: DWORD

Windows 95/98: Menentukan durasi, dalam milidetik, sinyal visual yang ditampilkan saat aplikasi berbasis Win32 (atau aplikasi yang berjalan di jendela) menghasilkan suara.

Windows NT/2000: Anggota ini dicadangkan untuk digunakan di masa mendatang. Ini harus diatur ke nol.

lpszWindowsEffectDLL

Jenis: LPTSTR

Anggota ini dicadangkan untuk digunakan di masa mendatang. Ini harus diatur ke NULL.

iWindowsEffectOrdinal

Jenis: DWORD

Anggota ini dicadangkan untuk digunakan di masa mendatang. Ini harus diatur ke nol.

Komentar

Aplikasi menggunakan struktur SOUNDSENTRY saat memanggil fungsi SystemParametersInfo dengan parameter uiAction diatur ke SPI_GETSOUNDSENTRY atau SPI_SETSOUNDSENTRY. Saat menggunakan SPI_GETSOUNDSENTRY, aplikasi harus menentukan cbSize anggota struktur SOUNDSENTRY; fungsi SystemParametersInfo mengisi anggota yang tersisa. Aplikasi harus menentukan cbSize, dwFlags, dan anggota iWindowsEffect saat menggunakan nilai SPI_SETSOUNDSENTRY.

Nota

Header winuser.h mendefinisikan SOUNDSENTRY sebagai alias yang secara otomatis memilih versi ANSI atau Unicode dari fungsi ini berdasarkan definisi konstanta preprosedur UNICODE. Mencampur penggunaan alias encoding-netral dengan kode yang tidak mengodekan-netral dapat menyebabkan ketidakcocokan yang mengakibatkan kesalahan kompilasi atau runtime. Untuk informasi selengkapnya, lihat Konvensi untuk Prototipe Fungsi.

Persyaratan

Syarat Nilai
klien minimum yang didukung Windows 2000 Professional [hanya aplikasi desktop]
server minimum yang didukung Windows 2000 Server [hanya aplikasi desktop]
Header winuser.h (termasuk Windows.h)

Lihat juga

Struktur Aksesibilitas

SoundSentryProc

SystemParametersInfo