EVT_WDF_IO_TARGET_QUERY_REMOVE回调函数 (wdfiotarget.h)

[适用于 KMDF 和 UMDF]

驱动程序的 EvtIoTargetQueryRemove 事件回调函数指示框架是否可以安全地删除指定的远程 I/O 目标设备。

语法

EVT_WDF_IO_TARGET_QUERY_REMOVE EvtWdfIoTargetQueryRemove;

NTSTATUS EvtWdfIoTargetQueryRemove(
  [in] WDFIOTARGET IoTarget
)
{...}

参数

[in] IoTarget

I/O 目标对象的句柄。

返回值

如果驱动程序确定框架可以安全地删除指定的 I/O 目标的设备,则 EvtIoTargetQueryRemove 回调函数必须返回STATUS_SUCCESS。 否则,此回调函数必须返回STATUS_UNSUCCESSFUL。

注解

如果驱动程序的 EvtIoTargetQueryRemove 回调函数返回STATUS_SUCCESS,则系统允许删除 I/O 目标的设备,除非其他驱动程序返回STATUS_UNSUCCESSFUL。

若要注册 EvtIoTargetQueryRemove 回调函数,请将回调函数的地址置于 I/O 目标的 WDF_IO_TARGET_OPEN_PARAMS 结构中。 EvtIoTargetQueryRemove 回调函数是可选的。 不提供此回调函数等效于返回STATUS_SUCCESS。

如果驱动程序确定 PnP 管理器可以安全地删除目标设备, 则 EvtIoTargetQueryRemove 回调函数必须调用 WdfIoTargetCloseForQueryRemove

回调函数必须禁用驱动程序向 I/O 目标发送其他 I/O 请求的功能。

有关 EvtIoTargetQueryRemove 回调函数的详细信息,请参阅 控制常规 I/O 目标的状态

要求

要求
目标平台 通用
最低 KMDF 版本 1.0
最低 UMDF 版本 2.0
标头 wdfiotarget.h (包括 Wdf.h)
IRQL PASSIVE_LEVEL

另请参阅

EvtIoTargetRemoveCanceled

EvtIoTargetRemoveComplete

WDF_IO_TARGET_OPEN_PARAMS

WdfIoTargetCloseForQueryRemove