Metode IAudioEndpointVolumeCallback::OnNotify (endpointvolume.h)

Metode OnNotify memberi tahu klien bahwa tingkat volume atau status mematikan suara perangkat titik akhir audio telah berubah.

Sintaks

HRESULT OnNotify(
  [in] PAUDIO_VOLUME_NOTIFICATION_DATA pNotify
);

Parameter

[in] pNotify

Arahkan ke data pemberitahuan volume. Parameter ini menunjuk ke struktur jenis AUDIO_VOLUME_NOTIFICATION_DATA.

Nilai kembali

Jika metode berhasil, metode akan mengembalikan S_OK. Jika gagal, kode kesalahan akan dikembalikan.

Keterangan

Parameter pNotify menunjuk ke struktur yang menjelaskan peristiwa perubahan volume yang memulai panggilan ke OnNotify. Struktur ini berisi GUID konteks peristiwa. GUID ini memungkinkan klien untuk membedakan antara perubahan volume (atau membisukan) yang dimulainya dan yang dimulai oleh beberapa klien lain. Saat memanggil metode IAudioEndpointVolume yang mengubah tingkat volume aliran, klien meneruskan pointer ke GUID konteks peristiwa yang dapat dikenali oleh implementasi metode OnNotify . Struktur yang ditujukkan oleh pNotify berisi GUID konteks ini. Jika klien yang mengubah tingkat volume memasok nilai pointer NULL untuk pointer ke GUID konteks peristiwa, nilai GUID konteks peristiwa dalam struktur yang ditujukkan oleh pNotify GUID_NULL.

Windows 7, antarmuka pengguna volume sistem tidak menentukan GUID_NULL ketika mengubah volume dalam sistem. Aplikasi OSD pihak ketiga dapat membedakan antara perubahan kontrol volume master yang dihasilkan dari antarmuka pengguna volume sistem, dan perubahan volume lainnya seperti perubahan dari handler kontrol volume bawaan.

Untuk contoh kode yang mengimplementasikan metode OnNotify , lihat Kontrol Volume Titik Akhir.

Persyaratan

Persyaratan	Nilai
Klien minimum yang didukung	Windows Vista [aplikasi desktop | Aplikasi UWP]
Server minimum yang didukung	Windows Server 2008 [aplikasi desktop | Aplikasi UWP]
Target Platform	Windows
Header	endpointvolume.h

Lihat juga

AUDIO_VOLUME_NOTIFICATION_DATA

Antarmuka IAudioEndpointVolume

Antarmuka IAudioEndpointVolumeCallback