Antarmuka IAudioSessionEvents (audiopolicy.h)

Antarmuka IAudioSessionEvents menyediakan pemberitahuan peristiwa terkait sesi seperti perubahan tingkat volume, nama tampilan, dan status sesi. Tidak seperti antarmuka lain di bagian ini, yang diimplementasikan oleh komponen sistem WASAPI, klien WASAPI mengimplementasikan antarmuka IAudioSessionEvents . Untuk menerima pemberitahuan peristiwa, klien meneruskan pointer ke antarmuka IAudioSessionEvents ke metode IAudioSessionControl::RegisterAudioSessionNotification .

Setelah mendaftarkan antarmuka IAudioClientSessionEvents , klien menerima pemberitahuan peristiwa dalam bentuk panggilan balik melalui metode di antarmuka.

Dalam menerapkan antarmuka IAudioSessionEvents , klien harus mengamati aturan ini untuk menghindari kebuntuan dan perilaku yang tidak terdefinisi:

• Metode dalam antarmuka harus tidak memblokir. Klien tidak boleh menunggu pada objek sinkronisasi selama panggilan balik peristiwa.
• Klien tidak boleh memanggil metode IAudioSessionControl::UnregisterAudioSessionNotification selama panggilan balik peristiwa.
• Klien tidak boleh merilis referensi akhir pada objek WASAPI selama panggilan balik peristiwa.

Untuk contoh kode yang mengimplementasikan antarmuka IAudioSessionEvents , lihat Peristiwa Sesi Audio. Untuk contoh kode yang mendaftarkan antarmuka IAudioSessionEvents klien untuk menerima pemberitahuan, lihat Peristiwa Audio untuk Aplikasi Audio Warisan.

Warisan

Antarmuka IAudioSessionEvents mewarisi dari antarmuka IUnknown . IAudioSessionEvents juga memiliki jenis anggota ini:

Metode

Antarmuka IAudioSessionEvents memiliki metode ini.

IAudioSessionEvents::OnChannelVolumeChanged Metode OnChannelVolumeChanged memberi tahu klien bahwa tingkat volume saluran audio dalam submix sesi telah berubah.
IAudioSessionEvents::OnDisplayNameChanged Metode OnDisplayNameChanged memberi tahu klien bahwa nama tampilan untuk sesi telah berubah.
IAudioSessionEvents::OnGroupingParamChanged Metode OnGroupingParamChanged memberi tahu klien bahwa parameter pengelompokan untuk sesi telah berubah.
IAudioSessionEvents::OnIconPathChanged Metode OnIconPathChanged memberi tahu klien bahwa ikon tampilan untuk sesi telah berubah.
IAudioSessionEvents::OnSessionDisconnected Metode OnSessionDisconnected memberi tahu klien bahwa sesi audio telah terputus.
IAudioSessionEvents::OnSimpleVolumeChanged Metode OnSimpleVolumeChanged memberi tahu klien bahwa tingkat volume atau status bisukan sesi audio telah berubah.
IAudioSessionEvents::OnStateChanged Metode OnStateChanged memberi tahu klien bahwa status aktivitas aliran sesi telah berubah.

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	audiopolicy.h

Lihat juga

Antarmuka Audio Inti

IAudioSessionControl::RegisterAudioSessionNotification

IAudioSessionControl::UnregisterAudioSessionNotification

WASAPI