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 目标的状态。