PowerDeterminePlatformRoleEx-Funktion (powerbase.h)
Bestimmt die Computerrolle für die angegebene Plattform.
Syntax
POWER_PLATFORM_ROLE PowerDeterminePlatformRoleEx(
[in] ULONG Version
);
Parameter
[in] Version
Die Version der POWER_PLATFORM_ROLE-Enumeration für die Plattform. Dieser Parameter kann einen der folgenden Werte annehmen.
| Wert | Bedeutung |
|---|---|
|
Die Version der POWER_PLATFORM_ROLE-Enumeration für das aktuelle Buildziel. |
|
Die Version der POWER_PLATFORM_ROLE-Enumeration für Windows 7, Windows Server 2008 R2, Windows Vista oder Windows Server 2008.
Der Aufruf von PowerDeterminePlatformRoleEx mit diesem Wert gibt das gleiche Ergebnis zurück wie der Aufruf von PowerDeterminePlatformRole unter Windows 7, Windows Server 2008 R2, Windows Vista oder Windows Server 2008. |
|
Die Version der POWER_PLATFORM_ROLE-Enumeration für Windows 8 und Windows Server 2012. |
Rückgabewert
Der Rückgabewert ist einer der Werte aus der angegebenen Version der POWER_PLATFORM_ROLE-Enumeration .
Hinweise
Diese Funktion liest die ACPI Fixed ACPI Description Table (FADT), um die vom OEM bevorzugte 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.
Wenn die vom OEM bevorzugte Computerrolle auf der vom Aufrufer angegebenen Plattform nicht unterstützt wird, gibt die Funktion den am nächstensten unterstützten Wert zurück. Wenn Sie beispielsweise die PowerDeterminePlatformRoleEx-Funktion mit einer Version von POWER_PLATFORM_ROLE_V1 auf einem Tablet-Gerät aufrufen, wird PlatformRoleMobile zurückgegeben.
Anforderungen
| Anforderung | Wert |
|---|---|
| Unterstützte Mindestversion (Client) | Windows 8 [nur Desktop-Apps] |
| Unterstützte Mindestversion (Server) | Windows Server 2012 [nur Desktop-Apps] |
| Zielplattform | Windows |
| Kopfzeile | powerbase.h |
| Bibliothek | Powrprof.lib |
| DLL | Powrprof.dll |