Fonction ReadPwrScheme (powrprof.h)
[ReadPwrScheme est disponible pour une utilisation dans les systèmes d’exploitation spécifiés dans la section Configuration requise. Il sera peut-être modifié ou indisponible dans les versions ultérieures. Voir Remarques.]
Récupère les paramètres de stratégie d’alimentation qui sont propres au schéma d’alimentation spécifié.
Syntaxe
BOOLEAN ReadPwrScheme(
[in] UINT uiID,
[out] PPOWER_POLICY pPowerPolicy
);
Paramètres
[in] uiID
Index du schéma d’alimentation à lire.
[out] pPowerPolicy
Pointeur vers une structure de POWER_POLICY qui reçoit les paramètres de stratégie d’alimentation.
Valeur retournée
Si la fonction réussit, la valeur de retour est différente de zéro.
Si la fonction échoue, la valeur de retour est égale à zéro. Pour obtenir des informations détaillées sur l’erreur, appelez GetLastError.
Remarques
Si le schéma d’alimentation spécifié n’existe pas, la fonction retourne FALSE.
Pour récupérer des informations sur les paramètres de stratégie d’alimentation actuellement utilisés par le système, appelez la fonction GetActivePwrScheme . Pour récupérer des informations supplémentaires sur les paramètres actuels de la stratégie d’alimentation, appelez la fonction CallNtPowerInformation .
À compter de Windows Vista, utilisez la fonction PowerEnumerate pour énumérer les paramètres d’alimentation d’un schéma spécifié et les fonctions power read pour récupérer des paramètres individuels.
Pour plus d’informations sur l’utilisation de PowrProf.h, consultez Power Schemes.
Configuration requise
| Condition requise | Valeur |
|---|---|
| Client minimal pris en charge | Windows XP [applications de bureau uniquement] |
| Serveur minimal pris en charge | Windows Server 2003 [applications de bureau uniquement] |
| Plateforme cible | Windows |
| En-tête | powrprof.h |
| Bibliothèque | PowrProf.lib |
| DLL | PowrProf.dll |