PowerDeterminePlatformRole-Funktion (powrprof.h)

Bestimmt die Computerrolle für Windows 7, Windows Server 2008 R2, Windows Vista oder Windows Server 2008. Um eine andere Plattform anzugeben, verwenden Sie die PowerDeterminePlatformRoleEx-Funktion .

Verwenden Sie PowerDeterminePlatformRoleEx, um zusätzliche Power Platform-Rollen abzufragen, die nach Windows 7 und Windows Server 2008 R2 definiert sind.

Syntax

POWER_PLATFORM_ROLE PowerDeterminePlatformRole();

Rückgabewert

Der Rückgabewert ist einer der Werte aus der POWER_PLATFORM_ROLE-Enumeration .

Hinweise

Diese Funktion liest die ACPI Fixed ACPI Description Table (FADT), um die bevorzugte OEM-Computerrolle zu bestimmen. Wenn diese Informationen nicht verfügbar sind, sucht die Funktion nach einem Akku. Wenn mindestens ein Akku verfügbar ist, gibt die Funktion PlatformRoleMobile zurück. Wenn keine Batterien verfügbar sind, gibt die Funktion PlatformRoleDesktop zurück.

Hinweis Diese API verfügt über eine neuere Version. Verwenden Sie PowerDeterminePlatformRoleEx, um zusätzliche Power Platform-Rollen abzufragen, die nach Windows 7 und Windows Server 2008 R2 definiert sind.

 

Anforderungen

Unterstützte Mindestversion (Client)	Windows Vista [nur Desktop-Apps]
Unterstützte Mindestversion (Server)	Windows Server 2008 [nur Desktop-Apps]
Zielplattform	Windows
Kopfzeile	powrprof.h
Bibliothek	PowrProf.lib
DLL	PowrProf.dll

Weitere Informationen

POWER_PLATFORM_ROLE

Energieverwaltungsfunktionen

PowerDeterminePlatformRoleEx