Fungsi PowerDeterminePlatformRoleEx (powerbase.h)

Menentukan peran komputer untuk platform yang ditentukan.

Sintaks

POWER_PLATFORM_ROLE PowerDeterminePlatformRoleEx(
  [in] ULONG Version
);

Parameter

[in] Version

Versi enumerasi POWER_PLATFORM_ROLE untuk platform. Parameter ini bisa menjadi salah satu nilai berikut.

Nilai	Makna
POWER_PLATFORM_ROLE_VERSION	Versi enumerasi POWER_PLATFORM_ROLE untuk target build saat ini.
POWER_PLATFORM_ROLE_V1	Versi enumerasi POWER_PLATFORM_ROLE untuk Windows 7, Windows Server 2008 R2, Windows Vista, atau Windows Server 2008. Memanggil PowerDeterminePlatformRoleEx dengan nilai ini mengembalikan hasil yang sama seperti memanggil PowerDeterminePlatformRole pada Windows 7, Windows Server 2008 R2, Windows Vista, atau Windows Server 2008.
POWER_PLATFORM_ROLE_V2	Versi enumerasi POWER_PLATFORM_ROLE untuk Windows 8 dan Windows Server 2012.

Mengembalikan nilai

Nilai yang dikembalikan adalah salah satu nilai dari versi enumerasi POWER_PLATFORM_ROLE yang ditentukan.

Keterangan

Fungsi ini membaca Acpi Fixed ACPI Description Table (FADT) untuk menentukan peran komputer pilihan OEM. Jika informasi tersebut tidak tersedia, fungsi mencari baterai. Jika setidaknya satu baterai tersedia, fungsi mengembalikan PlatformRoleMobile. Jika tidak ada baterai yang tersedia, fungsi mengembalikan PlatformRoleDesktop.

Jika peran komputer pilihan OEM tidak didukung pada platform yang ditentukan oleh pemanggil, fungsi mengembalikan nilai terdekat yang didukung. Misalnya, memanggil fungsi PowerDeterminePlatformRoleEx dengan VersiPOWER_PLATFORM_ROLE_V1 pada perangkat tablet mengembalikan PlatformRoleMobile.

Persyaratan

Persyaratan	Nilai
Klien minimum yang didukung	Windows 8 [khusus aplikasi desktop]
Server minimum yang didukung	Windows Server 2012 [hanya aplikasi desktop]
Target Platform	Windows
Header	powerbase.h
Pustaka	Powrprof.lib
DLL	Powrprof.dll

Lihat juga

POWER_PLATFORM_ROLE

Fungsi Manajemen Daya

PowerDeterminePlatformRole