EVT_WDF_IO_TARGET_QUERY_REMOVE回呼函式 (wdfiotarget.h)

[適用於 KMDF 和 UMDF]

驅動程式的 EvtIoTargetQueryRemove 事件回呼函式指出架構是否可以安全地移除指定的遠端 I/O 目標裝置。

語法

EVT_WDF_IO_TARGET_QUERY_REMOVE EvtWdfIoTargetQueryRemove;

NTSTATUS EvtWdfIoTargetQueryRemove(
  [in] WDFIOTARGET IoTarget
)
{...}

[in] IoTarget

I/O 目標物件的句柄。

如果驅動程式判斷架構可以安全地移除指定的 I/O 目標的裝置，EvtIoTargetQueryRemove 回呼函式必須傳回STATUS_SUCCESS。否則，這個回呼函式必須傳回STATUS_UNSUCCESSFUL。

如果驅動程式的 EvtIoTargetQueryRemove 回呼函式傳回STATUS_SUCCESS，除非其他驅動程式傳回STATUS_UNSUCCESSFUL，否則系統會允許移除 I/O 目標的裝置。

若要註冊 EvtIoTargetQueryRemove 回呼函式，請將回呼函式的位址放在 I/O 目標的 WDF_IO_TARGET_OPEN_PARAMS 結構中。 EvtIoTargetQueryRemove 回呼函式是選擇性的。未提供此回呼函式相當於傳回STATUS_SUCCESS。

如果驅動程序判斷 PnP 管理員可以安全地移除目標裝置， EvtIoTargetQueryRemove 回呼函式必須呼叫 WdfIoTargetCloseForQueryRemove。

回呼函式必須停用驅動程式將其他 I/O 要求傳送至 I/O 目標的能力。

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