USER_POWER_POLICY 구조체(powrprof.h)

아티클
08/25/2023

사용자의 각 전원 구성표에 고유한 전원 정책 설정을 포함합니다. 이 구조체는 POWER_POLICY 구조체의 일부입니다.

구문

typedef struct _USER_POWER_POLICY {
  ULONG               Revision;
  POWER_ACTION_POLICY IdleAc;
  POWER_ACTION_POLICY IdleDc;
  ULONG               IdleTimeoutAc;
  ULONG               IdleTimeoutDc;
  UCHAR               IdleSensitivityAc;
  UCHAR               IdleSensitivityDc;
  UCHAR               ThrottlePolicyAc;
  UCHAR               ThrottlePolicyDc;
  SYSTEM_POWER_STATE  MaxSleepAc;
  SYSTEM_POWER_STATE  MaxSleepDc;
  ULONG               Reserved[2];
  ULONG               VideoTimeoutAc;
  ULONG               VideoTimeoutDc;
  ULONG               SpindownTimeoutAc;
  ULONG               SpindownTimeoutDc;
  BOOLEAN             OptimizeForPowerAc;
  BOOLEAN             OptimizeForPowerDc;
  UCHAR               FanThrottleToleranceAc;
  UCHAR               FanThrottleToleranceDc;
  UCHAR               ForcedThrottleAc;
  UCHAR               ForcedThrottleDc;
} USER_POWER_POLICY, *PUSER_POWER_POLICY;

멤버

Revision

현재 구조 수정 수준입니다. USER_POWER_POLICY 구조를 사용하여 전원 정책을 설정하기 전에 GetCurrentPowerPolicies 또는 ReadPwrScheme을 호출하여 이 값을 설정합니다.

IdleAc

시스템이 AC(유틸리티) 전원에서 실행 중이고 시스템 유휴 타이머가 만료되는 경우 시작할 시스템 전원 작업을 정의하는 POWER_ACTION_POLICY 구조체입니다.

IdleDc

시스템이 배터리 전원으로 실행되고 시스템 유휴 타이머가 만료되는 경우 시작할 시스템 전원 작업을 정의하는 POWER_ACTION_POLICY 구조입니다.

IdleTimeoutAc

AC(유틸리티) 전원에서 실행할 때 시스템 유휴 타이머가 만료되기 전까지 시스템 작업 수준이 유휴 검색 임계값 아래로 유지되어야 하는 시간(초)입니다.

시스템이 사용자가 없기 때문에 자동화된 다시 시작을 수행하는 경우 이 멤버는 무시됩니다. 애플리케이션이 작업을 수행하는 동안 시스템을 일시적으로 실행하려면 SetThreadExecutionState 함수를 사용합니다.

IdleTimeoutDc

시스템 작업 수준이 유휴 검색 임계값 아래로 유지되어야 하는 시간(초)입니다. 배터리 전원에서 실행할 때 시스템 유휴 타이머가 만료됩니다.

IdleSensitivityAc

시스템이 AC(유틸리티) 전원에서 실행 중일 때 유휴 검색에 대한 임계값을 정의하는 시스템 작업 수준(백분율로 표시됨)입니다.

IdleSensitivityDc

시스템이 배터리 전원으로 실행 중일 때 유휴 감지 임계값을 정의하는 시스템 작업 수준(백분율로 표시됨)입니다.

ThrottlePolicyAc

시스템이 AC(유틸리티) 전원에서 실행될 때 사용할 프로세서 동적 제한 정책입니다.

ThrottlePolicyDc

시스템이 배터리 전원으로 실행될 때 사용할 프로세서 동적 제한 정책입니다.

MaxSleepAc

시스템이 AC(유틸리티) 전원에서 실행 중일 때의 최대 시스템 절전 모드 상태입니다. 이 멤버는 SYSTEM_POWER_STATE 열거형 형식 값 중 하나여야 합니다.

MaxSleepDc

시스템이 배터리 전원으로 실행 중일 때의 최대 시스템 절전 모드 상태입니다. 이 멤버는 SYSTEM_POWER_STATE 열거형 형식 값 중 하나여야 합니다.

Reserved[2]

예약되어 있습니다.

VideoTimeoutAc

시스템이 AC(유틸리티) 전원에서 실행 중일 때 디스플레이가 꺼진 시간(초)입니다.

VideoTimeoutDc

시스템이 배터리 전원으로 실행 중일 때 디스플레이가 꺼지는 시간(초)입니다.

SpindownTimeoutAc

시스템이 AC(유틸리티) 전원에서 실행 중일 때 고정 디스크 드라이브에 대한 전원이 꺼지는 시간(초)입니다.

SpindownTimeoutDc

시스템이 배터리 전원으로 실행 중일 때 고정 디스크 드라이브에 대한 전원이 꺼지는 시간(초)입니다.

OptimizeForPowerAc

이 멤버가 TRUE이면 수동 냉각이 지정되고 시스템이 AC(유틸리티) 전원에서 실행 중일 때 시스템이 냉각 팬을 켜고 프로세서를 전속적으로 실행합니다. 이로 인해 운영 체제가 팬을 사용하고 프로세서를 최대 속도로 실행하는 쪽으로 편향됩니다.

OptimizeForPowerDc

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

FanThrottleToleranceAc

시스템이 AC(유틸리티) 전원에서 작동하는 동안 열 이벤트에 대한 응답으로 시스템 팬을 켜기 전에 프로세서가 제한될 수 있는 하한은 백분율로 표시됩니다.

FanThrottleToleranceDc

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

ForcedThrottleAc

컴퓨터가 AC(유틸리티) 전원에서 실행되는 동안 시스템에 의해 부과되는 프로세서 스로틀 수준은 백분율로 표시됩니다.

ForcedThrottleDc

컴퓨터가 배터리 전원으로 실행되는 동안 시스템에 의해 부과되는 프로세서 스로틀 수준은 백분율로 표시됩니다.

요구 사항

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

추가 정보

POWER_ACTION_POLICY

POWER_POLICY

Share via

USER_POWER_POLICY 구조체(powrprof.h)

구문

멤버

요구 사항

추가 정보

피드백

피드백

추가 리소스