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