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 |