EVT_WDF_IO_TARGET_REMOVE_COMPLETE回调函数 (wdfiotarget.h)

项目
02/27/2024

[适用于 KMDF 和 UMDF]

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

语法

EVT_WDF_IO_TARGET_REMOVE_COMPLETE EvtWdfIoTargetRemoveComplete;

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

参数

[in] IoTarget

I/O 目标对象的句柄。

返回值

无

备注

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

在驱动程序的 EvtIoTargetQueryRemove 回调函数返回STATUS_SUCCESS后，或者在意外删除设备后，框架调用驱动程序的 EvtIoTargetRemoveComplete 回调函数， (意外删除) 。

驱动程序的 EvtIoTargetRemoveComplete 回调函数必须通过调用 WdfIoTargetClose 永久关闭远程 I/O 目标。由于已删除目标设备， 因此 EvtIoTargetRemoveComplete 回调函数还应执行可能必要的任何其他目标删除操作，例如释放驱动程序在打开目标时可能已分配的系统资源。

EvtIoTargetRemoveComplete 回调函数是可选的。如果驱动程序不提供此回调函数，框架将永久关闭 I/O 目标。

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