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 |