Share via

GetPwrCapabilities 함수(powerbase.h)

  • 아티클

시스템 전원 기능에 대한 정보를 검색합니다.

구문

BOOLEAN GetPwrCapabilities(
  [out] PSYSTEM_POWER_CAPABILITIES lpspc
);

매개 변수

[out] lpspc

정보를 수신하는 SYSTEM_POWER_CAPABILITIES 구조체에 대한 포인터입니다.

반환 값

함수가 성공하면 반환 값이 0이 아닙니다.

함수가 실패하면 반환 값은 0입니다. 확장 오류 정보를 가져오려면 GetLastError를 호출합니다.

설명

이 함수는 현재 시스템 전원 관리 하드웨어 리소스 및 기능에 대한 자세한 정보를 검색합니다. 여기에는 전원 버튼, 뚜껑 스위치 및 배터리와 같은 하드웨어 기능의 존재에 대한 정보가 포함됩니다. 반환된 다른 세부 정보에는 현재 지원되는 최소 절전 상태, 시스템에 새 드라이버가 도입될 때 변경될 수 있는 최소 절전 모드 상태 또는 시스템 최대 절전 모드 파일의 존재와 같이 동적으로 변경될 수 있는 현재 전원 관리 기능 및 구성에 대한 정보가 포함됩니다.

이 정보는 SystemPowerCapabilities 수준을 사용하여 CallNtPowerInformation 함수를 통해서도 사용할 수 있습니다.

PowrProf.h 사용에 대한 자세한 내용은 전원 구성표를 참조하세요.

요구 사항

요구 사항 값
지원되는 최소 클라이언트 Windows XP [데스크톱 앱만 해당]
지원되는 최소 서버 Windows Server 2003 [데스크톱 앱만 해당]
대상 플랫폼 Windows
헤더 powerbase.h
라이브러리 PowrProf.lib
DLL PowrProf.dll

추가 정보

CallNtPowerInformation

전원 관리 함수

SYSTEM_POWER_CAPABILITIES