共用方式為


EVT_WDF_IO_TARGET_REMOVE_COMPLETE回呼函式 (wdfiotarget.h)

[適用於 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 結構中。

架構會在驅動程式 EvtIoTargetRemoveComplete 回呼函式之後呼叫驅動程式的 EvtIoTargetQueryRemove, 回呼函式傳回STATUS_SUCCESS,或在裝置意外移除之後(意外移除)。

驅動程式的 EvtIoTargetRemoveComplete 回呼函式必須呼叫 WdfIoTargetClose來永久關閉遠端 I/O 目標。 因為已移除目標裝置,所以 EvtIoTargetRemoveComplete 回呼函式也應該執行可能需要的任何其他目標移除作業,例如釋放驅動程式在開啟目標時可能配置的系統資源。

EvtIoTargetRemoveComplete 回呼函式是選擇性的。 如果驅動程式未提供此回呼函式,架構就會永久關閉 I/O 目標。

如需 EvtIoTargetRemoveComplete 回呼函式的詳細資訊,請參閱 控制一般 I/O 目標的狀態

需求

要求 價值
目標平臺 普遍
最低 KMDF 版本 1.0
最低 UMDF 版本 2.0
標題 wdfiotarget.h (包括 Wdf.h)
IRQL PASSIVE_LEVEL

另請參閱

EvtIoTargetQueryRemove

EvtIoTargetRemoveCanceled

WDF_IO_TARGET_OPEN_PARAMS

WdfIoTargetClose