Metode IAudioEndpointVolume::UnregisterControlChangeNotify (endpointvolume.h)

  • Artikel

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
E_POINTER
 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

IAudioEndpointVolume::RegisterControlChangeNotify

Antarmuka IAudioEndpointVolumeCallback