Share via

PowerManagement_SetSystemPowerProfile 함수

  • 아티클

헤더: #include <applibs/powermanagement.h>

시스템 전원 프로필을 설정합니다. 시스템은 지정된 전원 프로필에 따라 전력 소비와 성능의 균형을 맞추기 위해 CPU 빈도를 동적으로 조정합니다.

int PowerManagement_SetSystemPowerProfile(PowerManagement_System_PowerProfile desired_profile);

참고

전원 프로필은 다시 부팅 시 유지되지 않으며 애플리케이션이 시작될 때 항상 설정해야 합니다.

매개 변수

  • PowerManagement_PowerSaver 는 시스템이 성능보다 전력 절감의 우선 순위를 지정해야 했음을 나타냅니다.
  • PowerManagement_Balanced 는 시스템이 시스템 부하에 따라 전력 절약과 성능의 균형을 유지해야 했음을 나타냅니다.
  • PowerManagement_HighPerformance 는 시스템이 전력 절감보다 성능 우선 순위를 지정해야 임을 나타냅니다.

오류

오류가 발생하고 를 오류 값으로 설정 errno 하면 -1을 반환합니다.

  • EACCES: 필요한 항목이 애플리케이션 매니페스트에 나열되지 않으므로 시스템 전원 프로필 설정에 대한 액세스가 허용되지 않습니다.
  • EINVAL: 잘못된 시스템 전원 프로필이 desired_profile 지정되었습니다.

다른 errno 모든 항목도 지정할 수 있습니다. 이러한 오류는 결정적이지 않으며 시스템 업데이트를 통해 동일한 동작이 유지되지 않을 수 있습니다.

반환 값

성공의 경우 0을 반환하고 실패의 경우 -1을 반환합니다. 이 경우 errno 오류 값으로 설정됩니다.

애플리케이션 매니페스트 요구 사항

PowerManagement_SetSystemPowerProfile()를 사용하려면 애플리케이션 매니페스트의 PowerControls 필드에서 SetPowerProfile 값을 선언해야 합니다.