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 |