GetPwrCapabilities, fonction (powerbase.h)
Récupère des informations sur les fonctionnalités d’alimentation du système.
Syntaxe
BOOLEAN GetPwrCapabilities(
[out] PSYSTEM_POWER_CAPABILITIES lpspc
);
Paramètres
[out] lpspc
Pointeur vers une structure SYSTEM_POWER_CAPABILITIES qui reçoit les informations.
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
Cette fonction récupère des informations détaillées sur les ressources et fonctionnalités matérielles de gestion de l’alimentation système actuelles. Cela inclut des informations sur la présence de fonctionnalités matérielles telles que les boutons d’alimentation, les commutateurs de couvercle et les piles. D’autres détails retournés incluent des informations sur les fonctionnalités et les configurations actuelles de gestion de l’alimentation qui peuvent changer dynamiquement, telles que l’état de veille minimal actuellement pris en charge, qui peut changer à mesure que de nouveaux pilotes sont introduits dans le système, ou la présence du fichier de mise en veille prolongée du système.
Ces informations sont également disponibles via la fonction CallNtPowerInformation , à l’aide du niveau SystemPowerCapabilities.
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 | powerbase.h |
| Bibliothèque | PowrProf.lib |
| DLL | PowrProf.dll |