Share via

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 를 호출하는 경우 ReducedLatencySleepAc 는 MaxSleepAc 대신 사용됩니다.

ReducedLatencySleepDc

배터리 전원으로 실행할 때 시스템 절전 모드 작업에 입력할 최대 시스템 전원 상태(가장 높은 Sx 값)와 뛰어난 대기 시간 요구 사항이 있는 경우. 이 멤버는 SYSTEM_POWER_STATE 열거형 형식 값 중 하나여야 합니다. 애플리케이션이 LT_LOWEST_LATENCY RequestWakeupLatency 를 호출하는 경우 ReducedLatencySleepAc 는 MaxSleepAc 대신 사용됩니다.

DozeTimeoutAc

이 멤버는 무시됩니다.

DozeTimeoutDc

이 멤버는 무시됩니다.

DozeS4TimeoutAc

시스템이 AC 전원에서 실행 중일 때 일시 중단 상태를 입력하고 최대 절전 모드 상태로 전환되는 시간(초)입니다. 값이 0이면 최대 절전 모드가 없음을 나타냅니다.

DozeS4TimeoutDc

시스템이 배터리 전원으로 실행 중일 때 일시 중단 상태를 입력하고 최대 절전 모드 상태로 전환되는 시간(초)입니다. 값이 0이면 최대 절전 모드가 없음을 나타냅니다.

MinThrottleAc

시스템이 AC 전원에서 실행될 때 초과 할당되기 전에 허용되는 최소 제한 설정입니다. 열 조건은 최소 설정 아래로 가는 유일한 이유가 될 것입니다. 프로세서가 과도하게 할당되면 시스템에서 OverThrottledAc 정책을 시작합니다. 전원 정책 관리자에는 열 영역이 중요한 열 상태를 표시할 때마다 CriticalShutdownOff를 시작하는 하드 코딩된 정책이 있습니다. 범위: 0-100.

MinThrottleDc

시스템이 배터리 전원으로 실행될 때 초과 할당되기 전에 허용되는 최소 제한 설정입니다. 열 조건은 최소 설정 아래로 가는 유일한 이유가 될 것입니다. 프로세서가 과도하게 할당되면 시스템에서 OverThrottledDc 정책을 시작합니다. 전원 정책 관리자에는 열 영역이 중요한 열 상태를 표시할 때마다 CriticalShutdownOff를 시작하는 하드 코딩된 정책이 있습니다. 범위: 0-100.

pad1[2]

예약되어 있습니다.

OverThrottledAc

시스템이 AC 전원에서 실행 중일 때 프로세서가 과도하게 할당될 때 수행할 작업을 정의하는 POWER_ACTION_POLICY 구조체입니다( MinThrottleAc 멤버에 의해 정의됨).

OverThrottledDc

시스템이 배터리 전원으로 실행 중일 때 프로세서가 과도하게 할당될 때 수행할 작업을 정의하는 POWER_ACTION_POLICY 구조체입니다( MinThrottleDc 멤버에 의해 정의됨).

설명

DozeS4TimeoutAc 및 DozeS4TimeoutDc는 SYSTEM_POWER_POLICYDozeS4Timeout 멤버에 해당합니다. 이러한 값은 전원 구성표를 적용하기 위해 SetActivePwrScheme 함수가 호출되면 컴퓨터 전원 정책에서 시스템 전원 정책으로 병합됩니다.

요구 사항

요구 사항 값
지원되는 최소 클라이언트 Windows XP [데스크톱 앱만 해당]
지원되는 최소 서버 Windows Server 2003 [데스크톱 앱만 해당]
머리글 powrprof.h

추가 정보

POWER_ACTION_POLICY

POWER_POLICY