Função PowerDeterminePlatformRoleEx (powerbase.h)
Determina a função de computador para a plataforma especificada.
Sintaxe
POWER_PLATFORM_ROLE PowerDeterminePlatformRoleEx(
[in] ULONG Version
);
Parâmetros
[in] Version
A versão do POWER_PLATFORM_ROLE enumeração para a plataforma. Esse parâmetro pode usar um dos valores a seguir.
| Valor | Significado |
|---|---|
|
A versão do POWER_PLATFORM_ROLE enumeração para o destino de build atual. |
|
A versão do POWER_PLATFORM_ROLE enumeração para Windows 7, Windows Server 2008 R2, Windows Vista ou Windows Server 2008.
Chamar PowerDeterminePlatformRoleEx com esse valor retorna o mesmo resultado que chamar PowerDeterminePlatformRole no Windows 7, Windows Server 2008 R2, Windows Vista ou Windows Server 2008. |
|
A versão da enumeração POWER_PLATFORM_ROLE para Windows 8 e Windows Server 2012. |
Retornar valor
O valor retornado é um dos valores da versão especificada da enumeração POWER_PLATFORM_ROLE .
Comentários
Essa função lê a FADT (Tabela de Descrição de ACPI Fixa) do ACPI para determinar a função de computador preferencial OEM. Se essas informações não estiverem disponíveis, a função procurará uma bateria. Se pelo menos uma bateria estiver disponível, a função retornará PlatformRoleMobile. Se nenhuma bateria estiver disponível, a função retornará PlatformRoleDesktop.
Se a função de computador preferencial OEM não tiver suporte na plataforma especificada pelo chamador, a função retornará o valor mais próximo com suporte. Por exemplo, chamar a função PowerDeterminePlatformRoleEx com uma versão de POWER_PLATFORM_ROLE_V1 em um dispositivo tablet retorna PlatformRoleMobile.
Requisitos
| Requisito | Valor |
|---|---|
| Cliente mínimo com suporte | Windows 8 [somente aplicativos da área de trabalho] |
| Servidor mínimo com suporte | Windows Server 2012 [somente aplicativos da área de trabalho] |
| Plataforma de Destino | Windows |
| Cabeçalho | powerbase.h |
| Biblioteca | Powrprof.lib |
| DLL | Powrprof.dll |