Metode IRemoteInterfaceCallbackEvent::OnRemoteInterfaceEvent (wudfddi.h)

Artikel
08/08/2023

[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

IRemoteInterfaceCallbackEvent

IRemoteInterfaceCallbackRemoval::OnRemoteInterfaceRemoval

Bagikan melalui