EVT_WDF_DEVICE_QUERY_REMOVE回呼函式 (wdfdevice.h)

  • 發行項

[適用於 KMDF 和 UMDF]

驅動程式的 EvtDeviceQueryRemove 事件回呼函式會判斷是否可以停止和移除指定的裝置。

語法

EVT_WDF_DEVICE_QUERY_REMOVE EvtWdfDeviceQueryRemove;

NTSTATUS EvtWdfDeviceQueryRemove(
  [in] WDFDEVICE Device
)
{...}

參數

[in] Device

架構裝置物件的句柄。

傳回值

如果驅動程式判斷裝置可以停止和移除， EvtDeviceQueryRemove 回呼函式必須傳回STATUS_SUCCESS或另一個狀態值， NT_SUCCESS (狀態) 等於 TRUE。 否則，它必須傳回狀態值，NT_SUCCESS (狀態) 等於 FALSE。 請勿傳回STATUS_NOT_SUPPORTED。

備註

若要註冊 EvtDeviceQueryRemove 回呼函式，驅動程式必須呼叫 WdfDeviceInitSetPnpPowerEventCallbacks。

如果裝置和驅動程式支援閑置電源關閉，當架構呼叫驅動程式的 EvtDeviceQueryRemove 回呼函式時，裝置可能無法處於其運作狀態。 回呼函式可以呼叫 WdfDeviceStopIdle 來強制裝置進入其運作 (D0) 狀態，然後回呼函式可以在傳回之前呼叫 WdfDeviceResumeIdle 。

如需 EvtDeviceQueryRemove 回呼函式的詳細資訊，請參閱 處理停止裝置的要求。

架構不會與其他 PnP 和電源管理回呼函式同步 EvtDeviceQueryRemove 回呼函式。 如需架構如何同步處理驅動程式事件回呼函式執行的資訊，請參閱 使用自動同步處理。

規格需求

需求 值
目標平台 Universal
最低 KMDF 版本 1.0
最低UMDF版本 2.0
標頭 wdfdevice.h (包含 Wdf.h)
IRQL PASSIVE_LEVEL

另請參閱

EvtDeviceQueryStop