EVT_WDF_IO_TARGET_REMOVE_COMPLETE回呼函式 (wdfiotarget.h)

發行項
02/29/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 結構中。

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

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

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

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