Metode IRemoteInterfaceCallbackEvent::OnRemoteInterfaceEvent (wudfddi.h)
[Peringatan: UMDF 2 adalah versi terbaru UMDF dan pengganti UMDF 1. Semua driver UMDF baru harus ditulis menggunakan UMDF 2. Tidak ada fitur baru yang ditambahkan ke UMDF 1 dan ada dukungan terbatas untuk UMDF 1 pada versi Windows 10 yang lebih baru. Driver Universal Windows harus menggunakan UMDF 2. Untuk informasi selengkapnya, lihat Mulai menggunakan UMDF.]
Fungsi panggilan balik peristiwa OnRemoteInterfaceEvent driver berbasis UMDF menangani peristiwa perangkat yang terkait dengan antarmuka perangkat.
Sintaks
void OnRemoteInterfaceEvent(
[in] IWDFRemoteInterface *pWdfRemoteInterface,
[in] REFGUID EventGuid,
[in, optional] BYTE *pbData,
[in] DWORD cbDataSize,
[in] DWORD NameBufferOffset
);
Parameter
[in] pWdfRemoteInterface
Penunjuk ke antarmuka IWDFRemoteInterface dari objek antarmuka jarak jauh yang mewakili antarmuka perangkat. Driver mendapatkan pointer ini ketika memanggil IWDFDevice2::CreateRemoteInterface.
[in] EventGuid
GUID yang mengidentifikasi jenis peristiwa. GUID Peristiwa didefinisikan oleh komponen yang mendukung GUID tersebut. Beberapa kelas antarmuka perangkat menyediakan GUID peristiwa, dan beberapa driver menyediakan peristiwa kustom.
[in, optional] pbData
Penunjuk ke buffer yang berisi data khusus peristiwa. Biasanya, komponen yang menentukan GUID peristiwa juga menentukan struktur khusus peristiwa untuk buffer peristiwa.
[in] cbDataSize
Ukuran, dalam byte, dari buffer yang dituju pbData .
[in] NameBufferOffset
Offset, dalam byte, dari awal buffer yang dituju pbData . Byte dari 0 ke NameBufferOffset-1 dari buffer berisi data biner. Byte dari NameBufferOffset ke akhir buffer berisi data string Unicode.
Nilai kembali
Tidak ada
Keterangan
Fungsi panggilan balik peristiwa OnRemoteInterfaceEvent driver menangani semua peristiwa perangkat kecuali peristiwa kedatangan dan penghapusan. Peristiwa tersebut dapat berasal dari panggilan driver berbasis UMDF ke IWDFDevice::P ostEvent atau dari panggilan driver mode kernel ke IoReportTargetDeviceChange atau IoReportTargetDeviceChangeAsynchronous.
Kerangka kerja mulai memanggil fungsi panggilan balik peristiwa OnRemoteInterfaceEvent setelah driver memanggil IWDFRemoteTarget::OpenRemoteInterface dan terus memanggil fungsi panggilan balik hingga target I/O jarak jauh antarmuka perangkat ditutup.
Untuk informasi selengkapnya tentang fungsi panggilan balik peristiwa OnRemoteInterfaceEvent driver, lihat Menggunakan Antarmuka Perangkat di Driver berbasis UMDF.
Persyaratan
Persyaratan | Nilai |
---|---|
Akhir dukungan | Tidak tersedia di UMDF 2.0 dan yang lebih baru. |
Target Platform | Desktop |
Versi UMDF minimum | 1.9 |
Header | wudfddi.h (termasuk Wudfddi.h) |
Lihat juga
IPnpCallbackRemoteInterfaceNotification::OnRemoteInterfaceArrival