EVT_WDF_IO_TARGET_REMOVE_CANCELED回呼函式 (wdfiotarget.h)

發行項
02/29/2024

[適用於 KMDF 和 UMDF]

驅動程式的 EvtIoTargetRemoveCanceled 事件回呼函式會在移除指定的遠端 I/O 目標取消時執行作業。

語法

EVT_WDF_IO_TARGET_REMOVE_CANCELED EvtWdfIoTargetRemoveCanceled;

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

參數

[in] IoTarget

I/O 目標物件的句柄。

傳回值

無

備註

若要註冊 EvtIoTargetRemoveCanceled 回呼函式，請將回呼函式的位址放在 I/O 目標的 WDF_IO_TARGET_OPEN_PARAMS 結構中。

如果驅動程式的 EvtIoTargetQueryRemove 回呼函式稱為 WdfIoTargetCloseForQueryRemove，驅動程式的 EvtIoTargetRemoveCanceled 回呼函式必須呼叫 WdfIoTargetOpen ，才能重新啟用將 I/O 要求傳送至 I/O 目標。當驅動程式呼叫 WdfIoTargetOpen 時，它可以為 WDF_IO_TARGET_OPEN_PARAMS 結構的 Type 成員指定 WdfIoTargetOpenReopen。

如果驅動程式未提供 EvtIoTargetQueryRemove 回呼函式，驅動程式的 EvtIoTargetRemoveCanceled 回呼函式可以選擇性地呼叫 WdfIoTargetOpen 並指定 WdfIoTargetOpenReopen。

選擇性 的 EvtIoTargetRemoveCanceled 回呼函式應該執行驅動程式繼續將 I/O 要求傳送至 I/O 目標之前可能需要的任何其他作業。

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