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