IPnpCallbackRemoteInterfaceNotification：：OnRemoteInterfaceArrival 方法 (wudfddi.h)

  • 项目

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

驱动程序的 OnRemoteInterfaceArrival 事件回调函数在 设备接口 可用时通知驱动程序。

语法

void OnRemoteInterfaceArrival(
  [in] IWDFRemoteInterfaceInitialize *pWdfRemoteInterfaceInit
);

参数

[in] pWdfRemoteInterfaceInit

指向 IWDFRemoteInterfaceInitialize 接口的指针，该接口标识已到达的设备接口。

返回值

无

备注

基于 UMDF 的驱动程序可以通过调用 IWDFDevice2：：RegisterRemoteInterfaceNotification 来注册其可选的 OnRemoteInterfaceArrival 事件回调函数。

驱动程序可以使用 IWDFRemoteInterfaceInitialize 接口的方法来确定到达的设备接口。

驱动程序必须先执行以下操作，然后驱动程序才能将 I/O 请求发送到设备接口：

  1. 调用 IWDFDevice2：：CreateRemoteInterface 来创建远程接口对象。
  2. 调用 IWDFDevice2：：CreateRemoteTarget 来创建远程目标对象。
  3. 调用 IWDFRemoteTarget：：OpenRemoteInterface 将接口对象连接到远程目标对象，并打开远程目标进行 I/O 操作。
有关使用远程接口对象访问设备接口的详细信息，请参阅 在基于 UMDF 的驱动程序中使用设备接口

要求

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

另请参阅

IPnpCallbackRemoteInterfaceNotification

IWDFDevice2：：CreateRemoteInterface

IWDFDevice2：：CreateRemoteTarget

IWDFRemoteInterfaceInitialize

IWDFRemoteTarget：：OpenRemoteInterface