EVT_WDF_IO_TARGET_REMOVE_CANCELED回调函数 (wdfiotarget.h)

项目
02/29/2024

[适用于 KMDF 和 UMDF]

驱动程序的 EvtIoTargetRemoveCanceled 事件回调函数在取消删除指定的远程 I/O 目标时执行操作。

语法

EVT_WDF_IO_TARGET_REMOVE_CANCELED EvtWdfIoTargetRemoveCanceled;

void EvtWdfIoTargetRemoveCanceled(
  [in] WDFIOTARGET IoTarget
)
{...}

参数

[in] IoTarget

I/O 目标对象的句柄。

返回值

无

备注

若要注册 EvtIoTargetRemoveCanceled 回调函数，请将回调函数的地址置于 I/O 目标的 WDF_IO_TARGET_OPEN_PARAMS 结构中。

如果驱动程序的 EvtIoTargetQueryRemove 回调函数名为 WdfIoTargetCloseForQueryRemove，则驱动程序的 EvtIoTargetRemoveCanceled 回调函数必须调用 WdfIoTargetOpen 以重新启用向 I/O 目标发送 I/O 请求。当驱动程序调用 WdfIoTargetOpen 时，它可以为 WDF_IO_TARGET_OPEN_PARAMS 结构的 Type 成员指定 WdfIoTargetOpenReopen。

如果驱动程序未提供 EvtIoTargetQueryRemove 回调函数，驱动程序的 EvtIoTargetRemoveCanceled 回调函数可以选择性地调用 WdfIoTargetOpen 并指定 WdfIoTargetOpenReopen。

可选的 EvtIoTargetRemoveCanceled 回调函数应在驱动程序继续向 I/O 目标发送 I/O 请求之前执行可能需要的任何其他操作。

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