PowerDeterminePlatformRoleEx 함수(powerbase.h)
지정된 플랫폼에 대한 컴퓨터 역할을 결정합니다.
구문
POWER_PLATFORM_ROLE PowerDeterminePlatformRoleEx(
[in] ULONG Version
);
매개 변수
[in] Version
플랫폼에 대한 POWER_PLATFORM_ROLE 열거형의 버전입니다. 이 매개 변수는 다음 값 중 하나일 수 있습니다.
| 값 | 의미 |
|---|---|
|
현재 빌드 대상에 대한 POWER_PLATFORM_ROLE 열거형의 버전입니다. |
|
Windows 7, Windows Server 2008 R2, Windows Vista 또는 Windows Server 2008에 대한 POWER_PLATFORM_ROLE 열거형 버전입니다.
이 값으로 PowerDeterminePlatformRoleEx 를 호출하면 Windows 7, Windows Server 2008 R2, Windows Vista 또는 Windows Server 2008에서 PowerDeterminePlatformRole 을 호출하는 것과 동일한 결과가 반환됩니다. |
|
Windows 8 및 Windows Server 2012 대한 POWER_PLATFORM_ROLE 열거형의 버전입니다. |
반환 값
반환 값은 지정된 버전의 POWER_PLATFORM_ROLE 열거형 값 중 하나입니다.
설명
이 함수는 ACPI FADT(고정 ACPI 설명 테이블)를 읽고 OEM 기본 설정 컴퓨터 역할을 확인합니다. 해당 정보를 사용할 수 없는 경우 함수는 배터리를 찾습니다. 하나 이상의 배터리를 사용할 수 있는 경우 함수는 PlatformRoleMobile을 반환합니다. 배터리를 사용할 수 없는 경우 함수는 PlatformRoleDesktop을 반환합니다.
호출자가 지정한 플랫폼에서 OEM 기본 설정 컴퓨터 역할이 지원되지 않는 경우 함수는 지원되는 가장 가까운 값을 반환합니다. 예를 들어 태블릿 디바이스에서 POWER_PLATFORM_ROLE_V1버전으로 PowerDeterminePlatformRoleEx 함수를 호출하면 PlatformRoleMobile이 반환됩니다.
요구 사항
| 요구 사항 | 값 |
|---|---|
| 지원되는 최소 클라이언트 | Windows 8 [데스크톱 앱만 해당] |
| 지원되는 최소 서버 | Windows Server 2012 [데스크톱 앱만 해당] |
| 대상 플랫폼 | Windows |
| 헤더 | powerbase.h |
| 라이브러리 | Powrprof.lib |
| DLL | Powrprof.dll |