Fonction PowerDeterminePlatformRoleEx (powerbase.h)
Détermine le rôle d’ordinateur pour la plateforme spécifiée.
Syntaxe
POWER_PLATFORM_ROLE PowerDeterminePlatformRoleEx(
[in] ULONG Version
);
Paramètres
[in] Version
Version du POWER_PLATFORM_ROLE énumération pour la plateforme. Ce paramètre peut prendre les valeurs suivantes.
| Valeur | Signification |
|---|---|
|
Version de l’énumération POWER_PLATFORM_ROLE pour la cible de build actuelle. |
|
La version de l’énumération POWER_PLATFORM_ROLE pour Windows 7, Windows Server 2008 R2, Windows Vista ou Windows Server 2008.
L’appel de PowerDeterminePlatformRoleEx avec cette valeur retourne le même résultat que l’appel de PowerDeterminePlatformRole sur Windows 7, Windows Server 2008 R2, Windows Vista ou Windows Server 2008. |
|
Version de l’énumération POWER_PLATFORM_ROLE pour Windows 8 et Windows Server 2012. |
Valeur retournée
La valeur de retour est l’une des valeurs de la version spécifiée de l’énumération POWER_PLATFORM_ROLE .
Remarques
Cette fonction lit la table de description ACPI fixe ACPI (FADT) pour déterminer le rôle d’ordinateur oem préféré. Si ces informations ne sont pas disponibles, la fonction recherche une batterie. Si au moins une batterie est disponible, la fonction retourne PlatformRoleMobile. Si aucune batterie n’est disponible, la fonction retourne PlatformRoleDesktop.
Si le rôle d’ordinateur préféré OEM n’est pas pris en charge sur la plateforme spécifiée par l’appelant, la fonction retourne la valeur prise en charge la plus proche. Par exemple, l’appel de la fonction PowerDeterminePlatformRoleEx avec une version de POWER_PLATFORM_ROLE_V1 sur une tablette renvoie PlatformRoleMobile.
Configuration requise
| Condition requise | Valeur |
|---|---|
| Client minimal pris en charge | Windows 8 [applications de bureau uniquement] |
| Serveur minimal pris en charge | Windows Server 2012 [applications de bureau uniquement] |
| Plateforme cible | Windows |
| En-tête | powerbase.h |
| Bibliothèque | Powrprof.lib |
| DLL | Powrprof.dll |