WdfDeviceGetDevicePowerState 関数 (wdfdevice.h)

[KMDF にのみ適用]

注意

この関数は、Microsoft 内部でのみ使用されます。

WdfDeviceGetDevicePowerState メソッドは、指定されたデバイスのフレームワークの電源状態マシンの現在の状態を返します。

構文

WDF_DEVICE_POWER_STATE WdfDeviceGetDevicePowerState(
  [in] WDFDEVICE Device
);

パラメーター

[in] Device

フレームワーク デバイス オブジェクトへのハンドル。

戻り値

WdfDeviceGetDevicePowerState は、指定されたデバイスのフレームワークの電源状態マシンの現在の状態を識別する、 WDF_DEVICE_POWER_STATE型指定された列挙子を返します。

ドライバーが無効なオブジェクト ハンドルを提供すると、バグ チェックが発生します。

注釈

フレームワークのステート マシンの詳細については、「 フレームワークのステート マシン」を参照してください。

WdfDeviceGetDevicePowerState メソッドは、次のコールバック関数内から呼び出された場合にのみ意味のある値を返します。

次のコード例では、指定したデバイスのフレームワークの電源状態マシンの現在の状態を取得します。

WDF_DEVICE_POWER_STATE state;

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

こちらもご覧ください

WdfDevStateNormalize

WdfDeviceGetDevicePnpState

WdfDeviceGetDevicePowerPolicyState