SYSTEM_POWER_POLICY 구조체(winnt.h)

  • 아티클

현재 시스템 전원 정책에 대한 정보를 포함합니다.

구문

typedef struct _SYSTEM_POWER_POLICY {
  DWORD               Revision;
  POWER_ACTION_POLICY PowerButton;
  POWER_ACTION_POLICY SleepButton;
  POWER_ACTION_POLICY LidClose;
  SYSTEM_POWER_STATE  LidOpenWake;
  DWORD               Reserved;
  POWER_ACTION_POLICY Idle;
  DWORD               IdleTimeout;
  BYTE                IdleSensitivity;
  BYTE                DynamicThrottle;
  BYTE                Spare2[2];
  SYSTEM_POWER_STATE  MinSleep;
  SYSTEM_POWER_STATE  MaxSleep;
  SYSTEM_POWER_STATE  ReducedLatencySleep;
  DWORD               WinLogonFlags;
  DWORD               Spare3;
  DWORD               DozeS4Timeout;
  DWORD               BroadcastCapacityResolution;
  SYSTEM_POWER_LEVEL  DischargePolicy[NUM_DISCHARGE_POLICIES];
  DWORD               VideoTimeout;
  BOOLEAN             VideoDimDisplay;
  DWORD               VideoReserved[3];
  DWORD               SpindownTimeout;
  BOOLEAN             OptimizeForPower;
  BYTE                FanThrottleTolerance;
  BYTE                ForcedThrottle;
  BYTE                MinThrottle;
  POWER_ACTION_POLICY OverThrottled;
} SYSTEM_POWER_POLICY, *PSYSTEM_POWER_POLICY;

멤버

Revision

현재 구조 수정 버전입니다.

PowerButton

시스템 전원 단추를 누를 때 시작할 시스템 전원 동작을 정의하는 POWER_ACTION_POLICY 구조체입니다.

SleepButton

시스템 절전 모드 단추를 누를 때 시작할 시스템 전원 동작을 정의하는 POWER_ACTION_POLICY 구조체입니다.

LidClose

시스템 덮개 스위치를 닫을 때 시작할 시스템 전원 동작을 정의하는 POWER_ACTION_POLICY 구조체입니다.

LidOpenWake

덮개 열기 이벤트가 시스템을 절전 모드에서 해제해야 하는 최대 전원 상태(가장 높은 Sx 값)입니다. 이 멤버는 SYSTEM_POWER_STATE 열거형 형식 값 중 하나여야 합니다.

Reserved

예약되어 있습니다.

Idle

시스템 유휴 타이머가 만료되는 경우 시작할 시스템 전원 작업을 정의하는 POWER_ACTION_POLICY 구조체입니다.

IdleTimeout

시스템 유휴 타이머가 만료되기 전까지 시스템 작업 수준이 유휴 검색 임계값 아래로 유지되어야 하는 시간(초)입니다.

IdleSensitivity

유휴 검색에 대한 임계값을 정의하는 시스템 활동 수준이며 백분율로 표시됩니다.

DynamicThrottle

현재 시스템 프로세서 동적 제한 정책입니다. 이 멤버는 프로세서 성능 제어 정책 상수에 설명된 값 중 하나여야 합니다.

Spare2[2]

예약되어 있습니다.

MinSleep

현재 지원되는 최소 시스템 절전 상태(가장 낮은 Sx 값)입니다. 이 멤버는 SYSTEM_POWER_STATE 열거형 형식 값 중 하나여야 합니다.

MaxSleep

현재 지원되는 최대 시스템 절전 상태(가장 높은 Sx 값)입니다. 이 멤버는 SYSTEM_POWER_STATE 열거형 형식 값 중 하나여야 합니다.

ReducedLatencySleep

미해결 대기 시간 요구 사항이 있는 경우 시스템 절전 모드 작업에 입력할 시스템 전원 상태(Sx 값)입니다. 이 멤버는 SYSTEM_POWER_STATE 열거형 형식 값 중 하나여야 합니다. 애플리케이션이 LT_LOWEST_LATENCY RequestWakeupLatency 를 호출하는 경우 ReducedLatencySleep 은 MaxSleep 대신 사용됩니다.

WinLogonFlags

이 멤버는 0이거나 WINLOGON_LOCK_ON_SLEEP(0x00000001)일 수 있습니다.

Spare3

예약되어 있습니다.

DozeS4Timeout

일시 중단 상태를 입력하고 최대 절전 모드 상태를 입력하는 시간(초)입니다. 값이 0이면 최대 절전 모드가 없음을 나타냅니다.

BroadcastCapacityResolution

시스템 전원 상태 변경 이벤트에 대한 알림을 시스템에 알려야 하는 현재 배터리 용량의 변경 해결.

DischargePolicy[NUM_DISCHARGE_POLICIES]

시스템 배터리 방전 이벤트에서 수행할 작업을 정의하는 SYSTEM_POWER_LEVEL 구조체의 배열입니다.

VideoTimeout

디스플레이가 꺼지기 전의 시간(초)입니다.

VideoDimDisplay

이 멤버가 TRUE이면 시스템에 디스플레이 디밍 지원이 포함됩니다.

VideoReserved[3]

예약되어 있습니다.

SpindownTimeout

고정 디스크 드라이브에 대한 전원이 꺼지기 전의 시간(초)입니다.

OptimizeForPower

이 멤버가 TRUE이면 시스템은 냉각 팬을 켜고 수동 냉각이 지정될 때 프로세서를 전속력으로 실행합니다. 이로 인해 운영 체제가 팬을 사용하고 프로세서를 최대 속도로 실행하는 쪽으로 편향됩니다.

FanThrottleTolerance

열 이벤트에 대한 응답으로 시스템 팬을 켜기 전에 프로세서가 제한될 수 있는 하한은 백분율로 표시됩니다.

ForcedThrottle

시스템에 의해 부과되는 프로세서 스로틀 수준(백분율로 표시됨).

MinThrottle

백분율로 표현되는 최소 프로세서 스로틀 수준입니다.

OverThrottled

프로세서 제한으로 시스템 온도를 적절하게 줄일 수 없는 경우 열 이벤트에 대응하여 시작할 시스템 전원 동작을 정의하는 POWER_ACTION_POLICY 구조체입니다.

요구 사항

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

추가 정보

CallNtPowerInformation

POWER_ACTION_POLICY

SYSTEM_POWER_LEVEL