WdfDeviceGetDevicePowerState 関数 (wdfdevice.h)
[KMDF にのみ適用]
手記
この関数は、Microsoft 内部でのみ使用されます。
WdfDeviceGetDevicePowerState メソッドは、指定したデバイスのフレームワークの電源状態マシンの現在の状態を返します。
構文
WDF_DEVICE_POWER_STATE WdfDeviceGetDevicePowerState(
[in] WDFDEVICE Device
);
パラメーター
[in] Device
フレームワーク デバイス オブジェクトへのハンドル。
戻り値
WdfDeviceGetDevicePowerState は、指定されたデバイスのフレームワークの電源ステート マシンの現在の状態を識別する WDF_DEVICE_POWER_STATE型指定された列挙子を返します。
ドライバーが無効なオブジェクト ハンドルを提供すると、バグ チェックが発生します。
備考
フレームワークのステート マシンの詳細については、「Framework でのステート マシンの」を参照してください。
WdfDeviceGetDevicePowerState メソッドは、次のコールバック関数内から呼び出された場合にのみ、意味のある値を返します。
-
EvtDevicePrepareHardware の
-
EvtDeviceReleaseHardware の
-
EvtDeviceD0Entry の
-
EvtDeviceD0Exit の
-
EvtDeviceSelfManagedIoInit の
-
EvtDeviceSelfManagedIoSuspend の
-
EvtDeviceSelfManagedIoRestart の
例
次のコード例では、指定したデバイスのフレームワークの電源ステート マシンの現在の状態を取得します。
WDF_DEVICE_POWER_STATE state;
state = WdfDeviceGetDevicePowerState(Device);
必要条件
| 要件 | 価値 |
|---|---|
| ターゲット プラットフォーム の | 万国 |
| 最小 KMDF バージョン | 1.0 |
| ヘッダー | wdfdevice.h (Wdf.h を含む) |
| ライブラリ | Wdf01000.sys (フレームワーク ライブラリのバージョン管理を参照)。 |
| IRQL | <= DISPATCH_LEVEL |
| DDI コンプライアンス規則 を する | DriverCreate(kmdf), KmdfIrql(kmdf), KmdfIrql2(kmdf), KmdfIrqlExplicit(kmdf) |
関連項目
WdfDeviceGetDevicePowerPolicyState の