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 枚举的版本。

此函数读取 ACPI 固定 ACPI 说明表 (FADT) 以确定 OEM 首选计算机角色。如果该信息不可用，则函数会查找电池。如果至少有一个电池可用，该函数将返回 PlatformRoleMobile。如果没有可用的电池，该函数返回 PlatformRoleDesktop。

如果调用方指定的平台上不支持 OEM 首选计算机角色，则函数将返回最接近的支持值。例如，在平板电脑设备上调用版本为 POWER_PLATFORM_ROLE_V1 的 PowerDeterminePlatformRoleEx 函数将返回 PlatformRoleMobile。