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 的调用，或者来自内核模式驱动程序对 IoReportTargetDeviceChange 或 IoReportTargetDeviceChangeAsynchronous 的调用。

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

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

要求

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

另请参阅

IPnpCallbackRemoteInterfaceNotification：：OnRemoteInterfaceArrival

IRemoteInterfaceCallbackEvent

IRemoteInterfaceCallbackRemoval：：OnRemoteInterfaceRemoval