WdfDeviceGetDevicePowerState 函式 (wdfdevice.h)

[僅適用於 KMDF]

注意

此函式僅供 Microsoft 內部使用。

WdfDeviceGetDevicePowerState 方法會針對指定的裝置傳回架構電源狀態計算機的目前狀態。

語法

WDF_DEVICE_POWER_STATE WdfDeviceGetDevicePowerState(
  [in] WDFDEVICE Device
);

參數

[in] Device

架構裝置物件的句柄。

傳回值

WdfDeviceGetDevicePowerState 會傳回 WDF_DEVICE_POWER_STATE類型列舉值，識別指定裝置之架構電源狀態計算機的目前狀態。

如果驅動程式提供無效的物件句柄，就會發生錯誤檢查。

備註

如需架構狀態機器的詳細資訊，請參閱 架構中的狀態機器。

只有在從下列回呼函式內呼叫 WdfDeviceGetDevicePowerState 方法時，才會傳回有意義的值：

• EvtDevicePrepareHardware

• EvtDeviceReleaseHardware

• EvtDeviceD0Entry

• EvtDeviceD0EntryPostInterruptsEnabled

• EvtDeviceD0Exit

• EvtDeviceD0ExitPreInterruptsDisabled

• EvtDeviceSelfManagedIoInit

• EvtDeviceSelfManagedIoSuspend

• EvtDeviceSelfManagedIoRestart

範例

下列程式代碼範例會取得指定裝置之架構電源狀態計算機的目前狀態。

WDF_DEVICE_POWER_STATE state;

state = WdfDeviceGetDevicePowerState(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)

另請參閱

WdfDevStateNormalize

WdfDeviceGetDevicePnpState

WdfDeviceGetDevicePowerPolicyState