IRemoteInterfaceCallbackRemoval::OnRemoteInterfaceRemoval 方法(wudfddi.h)

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

基于 UMDF 的驱动程序的 OnRemoteInterfaceRemoval 事件回调函数通知驱动程序它无法使用 设备接口,因为该接口已被删除。

语法

void OnRemoteInterfaceRemoval(
  [in] IWDFRemoteInterface *pWdfRemoteInterface
);

参数

[in] pWdfRemoteInterface

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

返回值

没有

言论

驱动程序的 OnRemoteInterfaceRemoval 事件回调函数必须执行任何特定于驱动程序的任务来处理删除设备接口所必需的任务。 此外,回调必须删除 IWDFDevice2::CreateRemoteInterface 创建的远程接口对象,如果接口以前调用了该接口的 AddRef 函数,则调用该接口的 Release 函数。

如果驱动程序未提供此回调函数,框架将删除 IWDFDevice2::CreateRemoteInterface 创建的远程接口对象。

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

要求

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

另请参阅

IPnpCallbackRemoteInterfaceNotification::OnRemoteInterfaceArrival

IRemoteInterfaceCallbackEvent::OnRemoteInterfaceEvent

IRemoteInterfaceCallbackRemoval