IRemoteTargetCallbackRemoval：：OnRemoteTargetQueryRemove 方法（wudfddi.h）

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

基于 UMDF 的驱动程序 OnRemoteTargetQueryRemove 事件回调函数确定是否可以停止和删除远程 I/O 目标的设备。

语法

BOOL OnRemoteTargetQueryRemove(
  [in] IWDFRemoteTarget *pWdfRemoteTarget
);

参数

[in] pWdfRemoteTarget

指向远程目标对象的 IWDFRemoteTarget 接口的指针，该接口表示 远程 I/O 目标。 驱动程序在调用 IWDFDevice2：：CreateRemoteTarget时获取此指针。

返回值

如果驱动程序确定设备可以停止和删除，OnRemoteTargetQueryRemove 事件回调函数必须返回 true。 否则，回调函数必须返回 FALSE。

言论

如果驱动程序提供 OnRemoteTargetQueryRemove 事件回调函数，回调函数应确定作系统是否应允许删除设备。 如果驱动程序确定可以删除设备，则应执行以下作：

1. 执行任何特定于驱动程序的作来停止远程目标的 I/O。
2. 调用 IWDFRemoteTarget：：CloseForQueryRemove。
3. 返回 TRUE，指示可以删除。

如果驱动程序未提供此回调函数，框架将调用 IWDFRemoteTarget：：CloseForQueryRemove 驱动程序。 换句话说，除非驱动程序提供 OnRemoteTargetQueryRemove 事件回调函数，否则框架始终允许删除设备。

有关 OnRemoteTargetQueryRemove 事件回调函数的详细信息，请参阅 控制 UMDF中的常规 I/O 目标状态。

要求

另请参阅

IRemoteTargetCallbackRemoval

IRemoteTargetCallbackRemoval：：OnRemoteTargetRemoveCanceled

IRemoteTargetCallbackRemoval：：OnRemoteTargetRemoveComplete