Función PowerDeterminePlatformRoleEx (powerbase.h)
Determina el rol de equipo para la plataforma especificada.
Sintaxis
POWER_PLATFORM_ROLE PowerDeterminePlatformRoleEx(
[in] ULONG Version
);
Parámetros
[in] Version
Versión de la enumeración POWER_PLATFORM_ROLE para la plataforma. Este parámetro puede ser uno de los valores siguientes.
| Valor | Significado |
|---|---|
|
Versión de la enumeración POWER_PLATFORM_ROLE para el destino de compilación actual. |
|
La versión de la enumeración POWER_PLATFORM_ROLE para Windows 7, Windows Server 2008 R2, Windows Vista o Windows Server 2008.
La llamada a PowerDeterminePlatformRoleEx con este valor devuelve el mismo resultado que llamar a PowerDeterminePlatformRole en Windows 7, Windows Server 2008 R2, Windows Vista o Windows Server 2008. |
|
Versión de la enumeración POWER_PLATFORM_ROLE para Windows 8 y Windows Server 2012. |
Valor devuelto
El valor devuelto es uno de los valores de la versión especificada de la enumeración POWER_PLATFORM_ROLE .
Comentarios
Esta función lee la tabla de descripción ACPI fija ACPI (FADT) para determinar el rol de equipo preferido de OEM. Si esa información no está disponible, la función busca una batería. Si hay al menos una batería disponible, la función devuelve PlatformRoleMobile. Si no hay baterías disponibles, la función devuelve PlatformRoleDesktop.
Si el rol de equipo preferido de OEM no es compatible con la plataforma especificada por el autor de la llamada, la función devuelve el valor admitido más cercano. Por ejemplo, al llamar a la función PowerDeterminePlatformRoleEx con una versión de POWER_PLATFORM_ROLE_V1 en un dispositivo de tableta, se devuelve PlatformRoleMobile.
Requisitos
| Requisito | Value |
|---|---|
| Cliente mínimo compatible | Windows 8 [solo aplicaciones de escritorio] |
| Servidor mínimo compatible | Windows Server 2012 [solo aplicaciones de escritorio] |
| Plataforma de destino | Windows |
| Encabezado | powerbase.h |
| Library | Powrprof.lib |
| Archivo DLL | Powrprof.dll |