MACHINE_POWER_POLICY 構造体 (powrprof.h)
コンピューター上の各電源スキームに固有のコンピューターの電源ポリシー設定が含まれています。 この構造体は、 POWER_POLICY 構造体の一部です。
構文
typedef struct _MACHINE_POWER_POLICY {
ULONG Revision;
SYSTEM_POWER_STATE MinSleepAc;
SYSTEM_POWER_STATE MinSleepDc;
SYSTEM_POWER_STATE ReducedLatencySleepAc;
SYSTEM_POWER_STATE ReducedLatencySleepDc;
ULONG DozeTimeoutAc;
ULONG DozeTimeoutDc;
ULONG DozeS4TimeoutAc;
ULONG DozeS4TimeoutDc;
UCHAR MinThrottleAc;
UCHAR MinThrottleDc;
UCHAR pad1[2];
POWER_ACTION_POLICY OverThrottledAc;
POWER_ACTION_POLICY OverThrottledDc;
} MACHINE_POWER_POLICY, *PMACHINE_POWER_POLICY;
メンバー
Revision
現在の構造リビジョン レベル。 この値を設定するには、MACHINE_POWER_POLICY構造体を使用して電源ポリシーを設定する前に、GetCurrentPowerPolicies または ReadPwrScheme を呼び出します。
MinSleepAc
AC 電源で実行するときにシステム スリープ アクションに入力する最小システム電源状態 (最小 Sx 値)。 このメンバーは、 SYSTEM_POWER_STATE 列挙型の値のいずれかである必要があります。
MinSleepDc
バッテリ電源で実行するときにシステム スリープ アクションに入る最小システム電源状態 (最小 Sx 値)。 このメンバーは、 SYSTEM_POWER_STATE 列挙型の値のいずれかである必要があります。
ReducedLatencySleepAc
AC 電源で実行しているとき、および未解決の待機時間要件がある場合にシステム スリープ アクションに入力する最大システム電源状態 (最大 Sx 値)。 このメンバーは、 SYSTEM_POWER_STATE 列挙型の値のいずれかである必要があります。 アプリケーションがLT_LOWEST_LATENCYを使用して RequestWakeupLatency を呼び出す場合、MaxSleepAc の代わりに ReducedLatencySleepAc が使用されます。
ReducedLatencySleepDc
バッテリ電源で実行しているとき、および未解決の待機時間要件がある場合にシステム スリープ アクションに入力する最大システム電源状態 (最大 Sx 値)。 このメンバーは、 SYSTEM_POWER_STATE 列挙型の値のいずれかである必要があります。 アプリケーションがLT_LOWEST_LATENCYを使用して RequestWakeupLatency を呼び出す場合、MaxSleepAc の代わりに ReducedLatencySleepAc が使用されます。
DozeTimeoutAc
このメンバーは無視されます。
DozeTimeoutDc
このメンバーは無視されます。
DozeS4TimeoutAc
システムが AC 電源で実行されているときに中断状態に入ってから休止状態のスリープ状態になるまでの待機時間 (秒単位)。 値が 0 の場合、休止状態になることはないことを示します。
DozeS4TimeoutDc
システムがバッテリ電源で実行されているときに、中断状態に入ってから休止状態になるまでの待機時間 (秒単位)。 値が 0 の場合、休止状態になることはないことを示します。
MinThrottleAc
システムが AC 電源で実行されているときにオーバーロットされる前に許容される最小スロットル設定。 温度条件は、最小設定を下回る唯一の理由になります。 プロセッサがオーバースロットされると、システムは OverThrottledAc ポリシーを開始します。 電源ポリシー マネージャーには、温度ゾーンが重大な温度条件を示すたびに CriticalShutdownOff を開始するハードコーディングされたポリシーがあることに注意してください。 範囲: 0 から 100。
MinThrottleDc
システムがバッテリ電源で実行されているときにオーバーロットされる前に許容される最小スロットル設定。 温度条件は、最小設定を下回る唯一の理由になります。 プロセッサがオーバースロットされると、システムは OverThrottledDc ポリシーを開始します。 電源ポリシー マネージャーには、温度ゾーンが重大な温度条件を示すたびに CriticalShutdownOff を開始するハードコーディングされたポリシーがあることに注意してください。 範囲: 0 から 100。
pad1[2]
予約済み。
OverThrottledAc
システムが AC 電源で実行されているときにプロセッサがオーバースロットされた (MinThrottleAc メンバーによって定義されている) ときに実行するアクションを定義するPOWER_ACTION_POLICY構造体。
OverThrottledDc
システムがバッテリ電源で実行されているときにプロセッサがオーバースロットされた場合に実行するアクションを定義するPOWER_ACTION_POLICY構造体 (MinThrottleDc メンバーによって定義されます)。
注釈
DozeS4TimeoutAc と DozeS4TimeoutDc は、SYSTEM_POWER_POLICYの DozeS4Timeout メンバーに対応します。 これらの値は、 SetActivePwrScheme 関数を呼び出して電源スキームを適用するときに、コンピューターの電源ポリシーからシステム電源ポリシーにマージされます。
要件
| 要件 | 値 |
|---|---|
| サポートされている最小のクライアント | Windows XP (デスクトップ アプリのみ) |
| サポートされている最小のサーバー | Windows Server 2003 (デスクトップ アプリのみ) |
| Header | powrprof.h |