Metode IAudioEndpointVolume::UnregisterControlChangeNotify (endpointvolume.h)
Metode UnregisterControlChangeNotify menghapus pendaftaran antarmuka panggilan balik pemberitahuan klien yang didaftarkan klien dalam panggilan sebelumnya ke metode IAudioEndpointVolume::RegisterControlChangeNotify .
Sintaks
HRESULT UnregisterControlChangeNotify(
[in] IAudioEndpointVolumeCallback *pNotify
);
Parameter
[in] pNotify
Arahkan ke antarmuka IAudioEndpointVolumeCallback klien. Klien meneruskan penunjuk antarmuka yang sama ini ke objek volume titik akhir dalam panggilan sebelumnya ke metode IAudioEndpointVolume::RegisterControlChangeNotify . Jika metode UnregisterControlChangeNotify berhasil, metode Rilis memanggil metode Rilis pada antarmuka IAudioEndpointVolumeCallback klien.
Mengembalikan nilai
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 pNotify adalah NULL. |
Keterangan
Sebelum klien merilis referensi terakhirnya ke antarmuka IAudioEndpointVolumeCallback , klien harus memanggil UnregisterControlChangeNotify untuk membatalkan pendaftaran antarmuka. Jika tidak, aplikasi membocorkan sumber daya yang dimiliki oleh objek IAudioEndpointVolumeCallback dan IAudioEndpointVolume . Perhatikan bahwa metode IAudioEndpointVolume::RegisterControlChangeNotify memanggil metode IAudioEndpointVolumeCallback::AddRef klien, dan Metode UnregisterControlChangeNotify memanggil metode IAudioEndpointVolumeCallback::Release . Jika klien melakukan kesalahan dengan merilis referensinya ke antarmuka IAudioEndpointVolumeCallback sebelum memanggil UnregisterControlChangeNotify, objek IAudioEndpointVolume tidak pernah merilis referensinya ke antarmuka IAudioEndpointVolumeCallback . Misalnya, implementasi IAudioEndpointVolumeCallback yang dirancang dengan buruk mungkin memanggil UnregisterControlChangeNotify dari destruktor untuk objek IAudioEndpointVolumeCallback . Dalam hal ini, klien tidak akan memanggil UnregisterControlChangeNotify sampai objek IAudioEndpointVolume merilis referensinya ke antarmuka IAudioEndpointVolumeCallback , dan objek IAudioEndpointVolume tidak akan merilis referensinya ke antarmuka IAudioEndpointVolumeCallback sampai klien memanggil UnregisterControlChangeNotify. Untuk informasi selengkapnya tentang metode AddRef dan Rilis , lihat diskusi antarmuka IUnknown dalam dokumentasi Windows SDK.
Untuk contoh kode yang memanggil UnregisterControlChangeNotify, lihat Kontrol Volume Titik Akhir.
Persyaratan
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
Antarmuka IAudioEndpointVolume