PowerDeterminePlatformRoleEx 函式 (powerbase.h)

決定指定平台的計算機角色。

語法

POWER_PLATFORM_ROLE PowerDeterminePlatformRoleEx(
  [in] ULONG Version
);

[in] Version

平臺的POWER_PLATFORM_ROLE 列舉版本。此參數可以是下列其中一個值。

值	意義
POWER_PLATFORM_ROLE_VERSION	目前組建目標的 POWER_PLATFORM_ROLE 列舉版本。
POWER_PLATFORM_ROLE_V1	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 相同的結果。
POWER_PLATFORM_ROLE_V2	Windows 8 和 Windows Server 2012的POWER_PLATFORM_ROLE列舉版本。

傳回值是指定版本的其中一個值，POWER_PLATFORM_ROLE 列舉。

此函式會讀取 ACPI 固定 ACPI 描述資料表 (FADT) ，以判斷 OEM 慣用的電腦角色。如果該資訊無法使用，函式會尋找電池。如果至少有一個電池可用，函式會傳回 PlatformRoleMobile。如果沒有電池可用，函式會傳回 PlatformRoleDesktop。

如果呼叫端指定的平臺上不支援 OEM 慣用的電腦角色，函式會傳回最接近的支援值。例如，在平板電腦裝置上呼叫PowerDeterminePlatformRoleEx函式，其版本為 POWER_PLATFORM_ROLE_V1會傳回 PlatformRoleMobile。