IControlChangeNotify::Metode OnNotify (devicetopology.h)

Artikel
02/29/2024

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

Sintaks

HRESULT OnNotify(
  [in] DWORD   dwSenderProcessId,
  [in] LPCGUID pguidEventContext
);

Parameter

[in] dwSenderProcessId

ID proses klien yang mengubah status kontrol. Jika pemberitahuan dihasilkan oleh peristiwa perangkat keras, ID proses ini akan berbeda dari ID proses klien. Untuk informasi selengkapnya, lihat Keterangan.

[in] pguidEventContext

Penunjuk ke GUID konteks untuk peristiwa perubahan kontrol. Klien yang memulai perubahan kontrol memasok GUID ini. Untuk informasi selengkapnya, lihat Keterangan.

Mengembalikan nilai

Jika metode berhasil, metode akan mengembalikan S_OK. Jika gagal, kode kesalahan akan ditampilkan.

Keterangan

Klien dapat menggunakan metode ini untuk melacak perubahan kontrol yang dibuat oleh proses lain dan oleh perangkat keras. Namun, klien yang mengubah pengaturan kontrol biasanya dapat mengalihkan pemberitahuan bahwa perubahan kontrol dihasilkan. Dalam implementasi metode OnNotify , klien dapat memeriksa parameter dwSenderProcessId dan pguidEventContext untuk menemukan apakah itu atau klien lain adalah sumber peristiwa perubahan kontrol.

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	devicetopology.h

Lihat juga

Antarmuka IControlChangeNotify

Share via