IRemoteInterfaceCallbackEvent::OnRemoteInterfaceEvent 方法(wudfddi.h)

[警告: UMDF 2 是最新版本的 UMDF,取代了 UMDF 1。 所有新的 UMDF 驱动程序都应使用 UMDF 2 编写。 没有将新功能添加到 UMDF 1,并且对较新版本的 Windows 10 上的 UMDF 1 的支持有限。 通用 Windows 驱动程序必须使用 UMDF 2。 有关详细信息,请参阅 UMDF入门 。]

基于 UMDF 的驱动程序 OnRemoteInterfaceEvent 事件回调函数处理与 设备接口关联的设备事件。

语法

void OnRemoteInterfaceEvent(
  [in]           IWDFRemoteInterface *pWdfRemoteInterface,
  [in]           REFGUID             EventGuid,
  [in, optional] BYTE                *pbData,
  [in]           DWORD               cbDataSize,
  [in]           DWORD               NameBufferOffset
);

参数

[in] pWdfRemoteInterface

指向表示设备接口的远程接口对象的 IWDFRemoteInterface 接口的指针。 驱动程序在调用 IWDFDevice2::CreateRemoteInterface时获取此指针。

[in] EventGuid

标识事件类型的 GUID。 事件 GUID 由支持此类 GUID 的组件定义。 某些 设备接口类 提供事件 GUID,某些驱动程序提供自定义事件。

[in, optional] pbData

指向包含特定于事件的数据的缓冲区的指针。 通常,定义事件 GUID 的组件也为事件缓冲区定义特定于事件的结构。

[in] cbDataSize

pbData 指向的缓冲区的大小(以字节为单位)。

[in] NameBufferOffset

pbData 指向的缓冲区开头的偏移量(以字节为单位)。 缓冲区的 0 到 NameBufferOffset-1 的字节数包含二进制数据。 从 NameBufferOffset 到缓冲区末尾的字节包含 Unicode 字符串数据。

返回值

没有

言论

驱动程序的 OnRemoteInterfaceEvent 事件回调函数处理除到达和删除事件之外的所有设备事件。 此类事件可能源自基于 UMDF 的驱动程序调用 IWDFDevice::P ostEvent,或从内核模式驱动程序调用 IoReportTargetDeviceChangeIoReportTargetDeviceChangeAsynchronous

该框架在驱动程序调用 IWDFRemoteTarget::OpenRemoteInterface 后开始调用 OnRemoteInterfaceEvent 事件回调函数,并继续调用回调函数,直到设备接口 远程 I/O 目标 关闭。

有关驱动程序 OnRemoteInterfaceEvent 事件回调函数的详细信息,请参阅 使用基于 UMDF 的驱动程序中的设备接口

要求

要求 价值
终止支持 在 UMDF 2.0 及更高版本中不可用。
目标平台 桌面
最低 UMDF 版本 1.9
标头 wudfddi.h (包括 Wudfddi.h)

另请参阅

IPnpCallbackRemoteInterfaceNotification::OnRemoteInterfaceArrival

IRemoteInterfaceCallbackEvent

IRemoteInterfaceCallbackRemoval::OnRemoteInterfaceRemoval