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