Bagikan melalui

Antarmuka IAudioSessionEvents (audiopolicy.h)

  • Artikel

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