Metode IAudioSessionControl::UnregisterAudioSessionNotification (audiopolicy.h)
Metode UnregisterAudioSessionNotification menghapus pendaftaran sebelumnya oleh klien untuk menerima pemberitahuan.
Sintaks
HRESULT UnregisterAudioSessionNotification(
[in] IAudioSessionEvents *NewNotifications
);
Parameter
[in] NewNotifications
Arahkan ke antarmuka IAudioSessionEvents yang diimplementasikan klien. Klien meneruskan penunjuk antarmuka yang sama ini ke manajer sesi dalam panggilan sebelumnya ke metode IAudioSessionControl::RegisterAudioSessionNotification . Jika metode UnregisterAudioSessionNotification berhasil, metode Rilis memanggil metode Rilis pada antarmuka IAudioSessionEvents klien.
Nilai kembali
Jika metode berhasil, metode akan mengembalikan S_OK. Jika gagal, kemungkinan kode pengembalian menyertakan, tetapi tidak terbatas pada, nilai yang diperlihatkan dalam tabel berikut.
| Menampilkan kode | Deskripsi |
|---|---|
|
Parameter NewNotifications adalah NULL. |
|
Antarmuka yang ditentukan sebelumnya tidak didaftarkan oleh klien atau telah dihapus. |
Keterangan
Klien memanggil metode ini ketika tidak perlu lagi menerima pemberitahuan. Metode UnregisterAudioSessionNotification menghapus pendaftaran antarmuka IAudioSessionEvents yang sebelumnya didaftarkan klien ke manajer sesi dengan memanggil metode IAudioSessionControl::RegisterAudioSessionNotification .
Sebelum klien merilis referensi terakhirnya ke antarmuka IAudioSessionEvents , klien harus memanggil UnregisterAudioSessionNotification untuk membatalkan pendaftaran antarmuka. Jika tidak, aplikasi membocorkan sumber daya yang dimiliki oleh objek IAudioSessionEvents dan IAudioSessionControl . Perhatikan bahwa RegisterAudioSessionNotification memanggil metode IAudioSessionEvents::AddRef klien, dan metode UnregisterAudioSessionNotification memanggil metode IAudioSessionEvents::Release . Jika klien melakukan kesalahan dengan merilis referensinya ke antarmuka IAudioSessionEvents sebelum memanggil UnregisterAudioSessionNotification, manajer sesi tidak pernah merilis referensinya ke antarmuka IAudioSessionEvents . Misalnya, implementasi IAudioSessionEvents yang dirancang dengan buruk mungkin memanggil UnregisterAudioSessionNotification dari destruktor untuk objek IAudioSessionEvents . Dalam hal ini, klien tidak akan memanggil UnregisterAudioSessionNotification sampai manajer sesi merilis referensinya ke antarmuka IAudioSessionEvents , dan manajer sesi tidak akan merilis referensinya ke antarmuka IAudioSessionEvents sampai klien memanggil UnregisterAudioSessionNotification. Untuk informasi selengkapnya tentang metode AddRef dan Rilis , lihat diskusi antarmuka IUnknown dalam dokumentasi Windows SDK.
Untuk contoh kode yang memanggil metode UnregisterAudioSessionNotification , lihat Peristiwa Audio untuk Aplikasi Audio Warisan.
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 IAudioSessionControl