次の方法で共有


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

戻りバッファーのサイズ (バイト単位)。

メモpReturnBufferNULL の場合、pBufferSize にはデータを返すために必要なサイズが入力されます。
 

戻り値

関数が成功すると、戻り値は 0 以外になります。

関数が失敗した場合は、0 を返します。

解説

QueryFlags パラメーターの値を組み合わせて、2 つ以上の条件をサポートするデバイスに対してクエリを実行できます。 例えば;PDCAP_D3_SUPPORTED PDCAP_D1_SUPPORTED | が QueryFlags パラメーターとして渡された場合、この関数は D3 または D1 をサポートするデバイスに対してクエリを実行します。

QueryFlagsQueryInterpretationFlagsDEVICEPOWER_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

関連項目

デバイスの電源管理