Metode IMMDeviceEnumerator::UnregisterEndpointNotificationCallback (mmdeviceapi.h)

Metode UnregisterEndpointNotificationCallback menghapus pendaftaran antarmuka pemberitahuan yang didaftarkan klien dalam panggilan sebelumnya ke metode IMMDeviceEnumerator::RegisterEndpointNotificationCallback .

Sintaks

HRESULT UnregisterEndpointNotificationCallback(
  [in] IMMNotificationClient *pClient
);

Parameter

[in] pClient

Arahkan ke antarmuka IMMNotificationClient klien. Klien meneruskan penunjuk antarmuka yang sama ini ke enumerator perangkat dalam panggilan sebelumnya ke metode IMMDeviceEnumerator::RegisterEndpointNotificationCallback . Untuk informasi selengkapnya, lihat Keterangan.

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
E_POINTER	Parameter pNotify adalah NULL.
E_NOTFOUND	Antarmuka pemberitahuan yang ditentukan tidak ditemukan.

Keterangan

Klien harus memastikan bahwa objek IMMNotificationClient tidak dirilis setelah panggilan RegisterEndpointNotificationCallback dan sebelum memanggil UnregisterEndpointNotificationCallback. Metode ini tidak memanggil implementasi IMMNotificationClient::AddRef dan IMMNotificationClient::Release klien. Klien bertanggung jawab untuk mempertahankan jumlah referensi objek IMMNotificationClient . Klien harus meningkatkan jumlah jika panggilan RegisterEndpointNotificationCallback berhasil dan merilis referensi akhir hanya setelah memanggil UnregisterEndpointNotificationCallback atau menerapkan beberapa mekanisme lain untuk memastikan bahwa objek tidak dihapus sebelum UnregisterEndpointNotificationCallback dipanggil. Jika tidak, aplikasi membocorkan sumber daya yang dimiliki oleh IMMNotificationClient dan objek lain yang diimplementasikan dalam kontainer yang sama.

Untuk informasi selengkapnya tentang metode AddRef dan Rilis , lihat diskusi antarmuka IUnknown dalam dokumentasi Windows SDK.

Persyaratan

Persyaratan	Nilai
Klien minimum yang didukung	Windows Vista [hanya aplikasi desktop]
Server minimum yang didukung	Windows Server 2008 [hanya aplikasi desktop]
Target Platform	Windows
Header	mmdeviceapi.h

Lihat juga

Antarmuka IMMDeviceEnumerator

IMMDeviceEnumerator::RegisterEndpointNotificationCallback

Antarmuka IMMNotificationClient