MÉTHODE IMDSPDevice ::GetPowerSource (mswmdm.h)

Article
08/25/2023

La méthode GetPowerSource indique si l’appareil est capable de fonctionner sur des batteries, une alimentation externe ou les deux, et sur quel type de source d’alimentation il est actuellement en cours d’exécution. Si l’appareil fonctionne sur des piles, cette méthode indique également le pourcentage de puissance totale restante dans les batteries.

Syntaxe

HRESULT GetPowerSource(
  [out] DWORD *pdwPowerSource,
  [out] DWORD *pdwPercentRemaining
);

Paramètres

[out] pdwPowerSource

Pointeur vers un DWORD qui reçoit une valeur indiquant la source d’alimentation actuelle de l’appareil. La valeur est l’un des indicateurs suivants.

Indicateur	Description
WMDM_POWER_CAP_BATTERY	Le périphérique multimédia peut s’exécuter sur des batteries.
WMDM_POWER_CAP_EXTERNAL	Le périphérique multimédia peut s’exécuter sur une alimentation externe.
WMDM_POWER_IS_BATTERY	Le périphérique multimédia s’exécute actuellement sur des batteries.
WMDM_POWER_IS_EXTERNAL	Le périphérique multimédia s’exécute actuellement sur une alimentation externe.
WMDM_POWER_PERCENT_AVAILABLE	Le pourcentage de puissance restante a été retourné dans pdwPercentRemaining.

[out] pdwPercentRemaining

Si l’appareil fonctionne sur batteries, pdwPercentRemaining spécifie un pointeur vers un DWORD contenant le pourcentage de puissance totale de la batterie restante.

Valeur retournée

Cette méthode retourne un code HRESULT. Toutes les méthodes d’interface dans Windows Media Gestionnaire de périphériques peuvent retourner l’une des classes de codes d’erreur suivantes :

Codes d’erreur COM standard
Codes d’erreur Windows convertis en valeurs HRESULT
Codes d’erreur Gestionnaire de périphériques Windows Media

Pour obtenir une liste complète des codes d’erreur possibles, consultez Codes d’erreur.

Remarques

Seuls les appareils physiques signalent les fonctionnalités de la source d’alimentation et la source d’alimentation actuelle. Les implémentations logicielles d’appareils ne signalent aucune capacité d’alimentation ou source d’alimentation actuelle.

Cette méthode est facultative. Pour plus d’informations, consultez Interfaces obligatoires et facultatives.

Configuration requise

Condition requise	Valeur
Plateforme cible	Windows
En-tête	mswmdm.h
Bibliothèque	Mssachlp.lib

Voir aussi

IMDSPDevice Interface

Partager via