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 |