DevicePowerEnumDevices 関数 (powrprof.h)
指定した条件を満たすシステム上のデバイスを列挙します。
構文
BOOLEAN DevicePowerEnumDevices(
[in] ULONG QueryIndex,
[in] ULONG QueryInterpretationFlags,
[in] ULONG QueryFlags,
[out, optional] PBYTE pReturnBuffer,
[in, out] PULONG pBufferSize
);
パラメーター
[in] QueryIndex
要求されたデバイスのインデックス。 初期呼び出しの場合、この値は 0 である必要があります。
[in] QueryInterpretationFlags
検索結果に適用される条件。
値 |
説明 |
- DEVICEPOWER_HARDWAREID
- 0x80000000
|
フレンドリ デバイス名ではなく、ハードウェア ID 文字列を返します。
|
- DEVICEPOWER_FILTER_DEVICES_PRESENT
- 0x20000000
|
システムに現在存在しないデバイスを無視します。
|
- DEVICEPOWER_AND_OPERATION
- 0x40000000
|
QueryFlags に対して AND 操作を実行します。
|
- DEVICEPOWER_FILTER_WAKEENABLED
- 0x08000000
|
スリープ状態からシステムをスリープ解除するためにデバイスが現在有効になっているかどうかを確認します。
|
- DEVICEPOWER_FILTER_ON_NAME
- 0x02000000
|
pReturnBuffer で渡された文字列と一致する名前を持つデバイスを検索し、QueryFlags に対してその機能をチェックします。
|
[in] QueryFlags
クエリ条件。
値 |
説明 |
- PDCAP_D0_SUPPORTED
- 0x00000001
|
デバイスでは、システム電源状態 D0 がサポートされています。
|
- PDCAP_D1_SUPPORTED
- 0x00000002
|
デバイスは、システム電源状態 D1 をサポートしています。
|
- PDCAP_D2_SUPPORTED
- 0x00000004
|
デバイスは、システム電源状態 D2 をサポートしています。
|
- PDCAP_D3_SUPPORTED
- 0x00000008
|
デバイスは、システム電源状態 D3 をサポートしています。
|
- PDCAP_S0_SUPPORTED
- 0x00010000
|
デバイスは、システム スリープ状態 S0 をサポートしています。
|
- PDCAP_S1_SUPPORTED
- 0x00020000
|
デバイスでは、システム スリープ状態 S1 がサポートされています。
|
- PDCAP_S2_SUPPORTED
- 0x00040000
|
このデバイスでは、システム スリープ状態 S2 がサポートされています。
|
- PDCAP_S3_SUPPORTED
- 0x00080000
|
デバイスは、システム スリープ状態 S3 をサポートしています。
|
- PDCAP_S4_SUPPORTED
- 0x01000000
|
デバイスでは、システム スリープ状態 S4 がサポートされています。
|
- PDCAP_S5_SUPPORTED
- 0x02000000
|
デバイスは、システム スリープ状態 S5 をサポートしています。
|
- PDCAP_WAKE_FROM_D0_SUPPORTED
- 0x00000010
|
デバイスは、システム電源状態 D0 からのウェイクをサポートしています。
|
- PDCAP_WAKE_FROM_D1_SUPPORTED
- 0x00000020
|
デバイスは、システム電源状態 D1 からのウェイクをサポートしています。
|
- PDCAP_WAKE_FROM_D2_SUPPORTED
- 0x00000040
|
デバイスは、システム電源状態 D2 からのウェイクをサポートしています。
|
- PDCAP_WAKE_FROM_D3_SUPPORTED
- 0x00000080
|
デバイスは、システム電源状態 D3 からのウェイクをサポートしています。
|
- PDCAP_WAKE_FROM_S0_SUPPORTED
- 0x00100000
|
デバイスは、システムスリープ状態 S0 からのウェイクをサポートしています。
|
- PDCAP_WAKE_FROM_S1_SUPPORTED
- 0x00200000
|
デバイスは、システムスリープ状態 S1 からのウェイクをサポートしています。
|
- PDCAP_WAKE_FROM_S2_SUPPORTED
- 0x00400000
|
デバイスは、システムスリープ状態 S2 からのウェイクをサポートしています。
|
- PDCAP_WAKE_FROM_S3_SUPPORTED
- 0x00800000
|
デバイスは、システムスリープ状態 S3 からのウェイクをサポートしています。
|
- PDCAP_WARM_EJECT_SUPPORTED
- 0x00000100
|
デバイスはウォーム イジェクタをサポートします。
|
[out, optional] pReturnBuffer
要求された情報を受け取るバッファーへのポインター。
[in, out] pBufferSize
戻りバッファーのサイズ (バイト単位)。
メモpReturnBuffer が NULL の場合、pBufferSize にはデータを返すために必要なサイズが入力されます。
戻り値
関数が成功すると、戻り値は 0 以外になります。
関数が失敗した場合は、0 を返します。
QueryFlags パラメーターの値を組み合わせて、2 つ以上の条件をサポートするデバイスに対してクエリを実行できます。 例えば;PDCAP_D3_SUPPORTED PDCAP_D1_SUPPORTED |
が QueryFlags パラメーターとして渡された場合、この関数は D3 または D1 をサポートするデバイスに対してクエリを実行します。
QueryFlags と QueryInterpretationFlags を DEVICEPOWER_AND_OPERATION に設定して、要求されたすべての条件をサポートするデバイスのクエリを生成することもできます。 例えば;PDCAP_D3_SUPPORTED PDCAP_D1_SUPPORTED | が QueryFlags パラメーターとして渡され、DEVICEPOWER_AND_OPERATIONQueryInterpretationFlags パラメーターとして渡された場合、この関数は D3 と D1 の両方をサポートするデバイスに対してクエリを実行します。
例
この関数を使用する例については、「 Device Power API の使用」を参照してください。
要件
|
|
サポートされている最小のクライアント |
Windows Vista [デスクトップ アプリのみ] |
サポートされている最小のサーバー |
Windows Server 2008 [デスクトップ アプリのみ] |
対象プラットフォーム |
Windows |
ヘッダー |
powrprof.h |
Library |
PowrProf.lib |
[DLL] |
PowrProf.dll |
関連項目
デバイスの電源管理