Share via

Функция 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
 Версия перечисления POWER_PLATFORM_ROLE для Windows 7, Windows Server 2008 R2, Windows Vista или Windows Server 2008.

Вызов PowerDeterminePlatformRoleEx с этим значением возвращает тот же результат, что и вызов PowerDeterminePlatformRole в Windows 7, Windows Server 2008 R2, Windows Vista или Windows Server 2008.
POWER_PLATFORM_ROLE_V2
 Версия перечисления POWER_PLATFORM_ROLE для Windows 8 и Windows Server 2012.

Возвращаемое значение

Возвращаемое значение является одним из значений из указанной версии перечисления POWER_PLATFORM_ROLE .

Комментарии

Эта функция считывает acpi fixed ACPI Description Table (FADT) для определения предпочтительной роли компьютера изготовителя оборудования. Если эти сведения недоступны, функция ищет аккумулятор. Если доступен хотя бы один аккумулятор, функция возвращает PlatformRoleMobile. Если батарей нет, функция возвращает PlatformRoleDesktop.

Если роль компьютера, предпочитаемая изготовителем оборудования, не поддерживается на платформе, указанной вызывающим объектом, функция возвращает ближайшее поддерживаемое значение. Например, вызов функции PowerDeterminePlatformRoleEx с версиейPOWER_PLATFORM_ROLE_V1 на планшетном устройстве возвращает PlatformRoleMobile.

Требования

Требование Значение
Минимальная версия клиента Windows 8 [только классические приложения]
Минимальная версия сервера Windows Server 2012 [только классические приложения]
Целевая платформа Windows
Header powerbase.h
Библиотека Powrprof.lib
DLL Powrprof.dll

См. также раздел

POWER_PLATFORM_ROLE

Функции управления питанием

PowerDeterminePlatformRole