Metode IMMDeviceEnumerator::RegisterEndpointNotificationCallback (mmdeviceapi.h)
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 |
---|---|
|
Parameter pNotify adalah NULL. |
|
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
Saran dan Komentar
https://aka.ms/ContentUserFeedback.
Segera hadir: Sepanjang tahun 2024 kami akan menghentikan penggunaan GitHub Issues sebagai mekanisme umpan balik untuk konten dan menggantinya dengan sistem umpan balik baru. Untuk mengetahui informasi selengkapnya, lihat:Kirim dan lihat umpan balik untuk