Funzione PowerDeterminePlatformRoleEx (powerbase.h)
Determina il ruolo computer per la piattaforma specificata.
Sintassi
POWER_PLATFORM_ROLE PowerDeterminePlatformRoleEx(
[in] ULONG Version
);
Parametri
[in] Version
Versione dell'enumerazione POWER_PLATFORM_ROLE per la piattaforma. Questo parametro può avere uno dei valori seguenti.
| Valore | Significato |
|---|---|
|
Versione dell'enumerazione POWER_PLATFORM_ROLE per la destinazione di compilazione corrente. |
|
Versione dell'enumerazione POWER_PLATFORM_ROLE per Windows 7, Windows Server 2008 R2, Windows Vista o Windows Server 2008.
La chiamata a PowerDeterminePlatformRoleEx con questo valore restituisce lo stesso risultato della chiamata a PowerDeterminePlatformRole in Windows 7, Windows Server 2008 R2, Windows Vista o Windows Server 2008. |
|
Versione dell'enumerazione POWER_PLATFORM_ROLE per Windows 8 e Windows Server 2012. |
Valore restituito
Il valore restituito è uno dei valori della versione specificata dell'enumerazione POWER_PLATFORM_ROLE .
Commenti
Questa funzione legge la tabella descrizione ACPI fissa ACPI (FADT) per determinare il ruolo computer preferito dall'OEM. Se tali informazioni non sono disponibili, la funzione cerca una batteria. Se è disponibile almeno una batteria, la funzione restituisce PlatformRoleMobile. Se non sono disponibili batterie, la funzione restituisce PlatformRoleDesktop.
Se il ruolo computer preferito oem non è supportato nella piattaforma specificata dal chiamante, la funzione restituisce il valore supportato più vicino. Ad esempio, la chiamata alla funzione PowerDeterminePlatformRoleEx con una versione di POWER_PLATFORM_ROLE_V1 in un dispositivo tablet restituisce PlatformRoleMobile.
Requisiti
| Requisito | Valore |
|---|---|
| Client minimo supportato | Windows 8 [solo app desktop] |
| Server minimo supportato | Windows Server 2012 [solo app desktop] |
| Piattaforma di destinazione | Windows |
| Intestazione | powerbase.h |
| Libreria | Powrprof.lib |
| DLL | Powrprof.dll |