EVT_WDF_DEVICE_QUERY_STOP回呼函式 (wdfdevice.h)

  • 發行項

[適用於 KMDF 和 UMDF]

驅動程式的 EvtDeviceQueryStop 事件回呼函式會決定是否可以停止指定的裝置，讓 PnP 管理員可以轉散發系統硬體資源。

語法

EVT_WDF_DEVICE_QUERY_STOP EvtWdfDeviceQueryStop;

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

參數

[in] Device

架構裝置物件的句柄。

傳回值

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

備註

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

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

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

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

規格需求

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

另請參閱

EvtDeviceQueryRemove