EVT_WDF_IO_TARGET_REMOVE_COMPLETE回调函数（wdfiotarget.h）

2025-03-22

[适用于 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或设备意外删除后调用驱动程序的 EvtIoTargetRemove 回调函数。

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

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

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