Struktur SOUNDSENTRYA (winuser.h)
Berisi informasi tentang fitur aksesibilitas SoundSentry. Saat fitur SoundSentry aktif, komputer hanya menampilkan indikasi visual 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.
Sintaks
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:
iFSTextEffect
Jenis: DWORD
Windows 95/98: Menentukan sinyal visual untuk disajikan saat aplikasi mode teks menghasilkan suara saat berjalan di komputer virtual layar penuh. Anggota ini bisa menjadi salah satu nilai berikut:
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 untuk disajikan ketika aplikasi mode grafis menghasilkan suara saat berjalan di komputer virtual layar penuh. Anggota ini bisa menjadi salah satu nilai berikut:
Nilai | Makna |
---|---|
|
Flash seluruh tampilan. |
|
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:
iWindowsEffectMSec
Jenis: DWORD
Windows 95/98: Menentukan durasi, dalam milidetik, dari 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.
Keterangan
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 anggota cbSize dari struktur SOUNDSENTRY ; fungsi SystemParametersInfo mengisi anggota yang tersisa. Aplikasi harus menentukan anggota cbSize, dwFlags, dan iWindowsEffect saat menggunakan nilai SPI_SETSOUNDSENTRY .
Catatan
Header winuser.h mendefinisikan SOUNDSENTRY sebagai alias yang secara otomatis memilih versi ANSI atau Unicode dari fungsi ini berdasarkan definisi konstanta pra-prosesor 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
Klien minimum yang didukung | Windows 2000 Professional [hanya aplikasi desktop] |
Server minimum yang didukung | Windows 2000 Server [hanya aplikasi desktop] |
Header | winuser.h (sertakan Windows.h) |
Lihat juga
Saran dan Komentar
https://aka.ms/ContentUserFeedback.
Segera hadir: Sepanjang tahun 2024 kami akan menghentikan penggunaan GitHub Issues sebagai mekanisme umpan balik untuk konten dan menggantinya dengan sistem umpan balik baru. Untuk mengetahui informasi selengkapnya, lihat:Kirim dan lihat umpan balik untuk