Antarmuka IControlChangeNotify (devicetopology.h)

Antarmuka IControlChangeNotify menyediakan pemberitahuan saat status bagian (konektor atau subunit) berubah. Tidak seperti antarmuka lain di bagian ini, yang diimplementasikan oleh DeviceTopology API, antarmuka IControlChangeNotify harus diimplementasikan oleh klien. Untuk menerima pemberitahuan, klien meneruskan pointer ke instans antarmuka IControlChangeNotify sebagai parameter ke metode IPart::RegisterControlChangeCallback .

Setelah mendaftarkan antarmuka IControlChangeNotify-nya , klien menerima pemberitahuan peristiwa dalam bentuk panggilan balik melalui metode OnNotify di antarmuka.

Dalam menerapkan antarmuka IControlChangeNotify , klien harus mengamati aturan ini untuk menghindari kebuntuan dan perilaku yang tidak terdefinisi:

  • Metode dalam antarmuka harus tidak diblokir. Klien tidak boleh menunggu pada objek sinkronisasi selama panggilan balik peristiwa.
  • Klien tidak boleh memanggil metode IPart::UnregisterControlChangeCallback selama panggilan balik peristiwa.
  • Klien tidak boleh merilis referensi akhir pada objek MMDevice API selama panggilan balik peristiwa.

Warisan

Antarmuka IControlChangeNotify mewarisi dari antarmuka IUnknown . IControlChangeNotify juga memiliki jenis anggota ini:

Metode

Antarmuka IControlChangeNotify memiliki metode ini.

 
IControlChangeNotify::OnNotify

Metode OnNotify memberi tahu klien ketika status konektor atau subunit berubah.

Persyaratan

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

Lihat juga

Antarmuka Audio Inti

DeviceTopology API

IPart::RegisterControlChangeCallback

IPart::UnregisterControlChangeCallback