共用方式為


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