Metode IMMDeviceEnumerator::RegisterEndpointNotificationCallback (mmdeviceapi.h)

  • Artikel

Metode RegisterEndpointNotificationCallback mendaftarkan antarmuka panggilan balik pemberitahuan klien.

Sintaks

HRESULT RegisterEndpointNotificationCallback(
  [in] IMMNotificationClient *pClient
);

Parameter

[in] pClient

Arahkan ke antarmuka IMMNotificationClient yang didaftarkan klien untuk panggilan balik pemberitahuan.

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_OUTOFMEMORY
 Kehabisan memori.

Keterangan

Metode ini mendaftarkan antarmuka IMMNotificationClient untuk dipanggil oleh sistem ketika peran, status, keberadaan, atau properti perangkat titik akhir berubah. Pemanggil mengimplementasikan antarmuka IMMNotificationClient.

Ketika pemberitahuan tidak lagi diperlukan, klien dapat memanggil metode IMMDeviceEnumerator::UnregisterEndpointNotificationCallback untuk mengakhiri pemberitahuan.

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::UnregisterEndpointNotificationCallback

Antarmuka IMMNotificationClient