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

こちらもご覧ください

POWER_ACTION_POLICY

POWER_POLICY