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);

要件	値
対象プラットフォーム	ユニバーサル
最小 KMDF バージョン	1.0
Header	wdfdevice.h (Wdf.h を含む)
Library	Wdf01000.sys (「Framework ライブラリのバージョン管理」を参照)。
IRQL	<= DISPATCH_LEVEL
DDI コンプライアンス規則	DriverCreate(kmdf), KmdfIrql(kmdf), KmdfIrql2(kmdf), KmdfIrqlExplicit(kmdf)