WdfDeviceGetDevicePowerPolicyState 函式 (wdfdevice.h)
[僅適用於 KMDF]
注意
此函式僅供 Microsoft 內部使用。
WdfDeviceGetDevicePowerPolicyState 方法會針對指定的裝置傳回架構電源原則狀態計算機的目前狀態。
語法
WDF_DEVICE_POWER_POLICY_STATE WdfDeviceGetDevicePowerPolicyState(
[in] WDFDEVICE Device
);
參數
[in] Device
架構裝置物件的句柄。
傳回值
WdfDeviceGetDevicePowerPolicyState 會傳回 WDF_DEVICE_POWER_POLICY_STATE型別列舉值，識別指定裝置之架構電源原則狀態計算機的目前狀態。
如果驅動程式提供無效的物件句柄，就會發生錯誤檢查。
備註
如需架構狀態機器的詳細資訊，請參閱 架構中的狀態機器。
WdfDeviceGetDevicePowerPolicyState 方法只有在從驅動程式呼叫 WdfDeviceInitSetPowerPolicyEventCallbacks 時所註冊的回呼函式內呼叫時，才會傳回有意義的值。
範例
下列程式代碼範例會取得指定裝置之架構電源原則狀態計算機的目前狀態。
WDF_DEVICE_POWER_POLICY_STATE devicePowerPolicyState;
devicePowerPolicyState = WdfDeviceGetDevicePowerPolicyState(Device);
規格需求
| 需求 | 值 |
|---|---|
| 目標平台 | Universal |
| 最低 KMDF 版本 | 1.0 |
| 標頭 | wdfdevice.h (包含 Wdf.h) |
| 程式庫 | Wdf01000.sys (請參閱 Framework Library Versioning.) |
| IRQL | <= DISPATCH_LEVEL |
| DDI 合規性規則 | DriverCreate (kmdf) 、 KmdfIrql (kmdf) 、 KmdfIrql2 (kmdf) 、 KmdfIrqlExplicit (kmdf) |