Skip to main content

PIXGetPowerMetrics

Retourne la charge énergétique actuelle sur les consoles XBOX Series.
La valeur de charge énergétique n’est pas prise en charge sur les consoles de la famille XBOX One. Sur ces consoles, la structure PIXPowerMetrics renseignée par PIXGetPowerMetrics contiendra toujours une valeur de charge énergétique de 0.
PIXGetPowerMetrics aide les développeurs à suivre la consommation d’énergie globale de leur titre. Cette API a été conçue pour permettre aux développeurs d’apporter des modifications ciblées, invisibles pour le joueur, mais qui contribuent à réduire la consommation d’énergie globale de leur titre exécuté sur la console.

Syntaxe

Paramètres

metrics
Type : PPIXPowerMetrics
Pointeur vers une structure PIXPowerMetrics. Au retour, le champ GpuAvgPowerLoadPct de la structure PIXPowerMetrics est renseigné avec la valeur actuelle de la charge énergétique de la console. Sur les consoles XBOX Series, la valeur de charge énergétique est un pourcentage compris entre 0 et 100. Sur les consoles de la famille XBOX One, la valeur de charge énergétique est toujours 0.

Valeur de retour

Type : HRESULT

Remarques

La valeur de charge énergétique retournée par PIXGetPowerMetrics est la même que celle signalée par le compteur Load % sous le nœud Power Monitor du System Monitor de PIX. Cette valeur est également affichée sur le panneau avant des kits de développement XBOX. Pour déterminer la charge énergétique d’une console XBOX Series S, la valeur retournée par PIXGetPowerMetrics lors de l’exécution en Lockhart profiling mode sur un kit de développement XBOX Series X peut être utilisée pour ajuster un titre, mais pour obtenir des mesures précises (pour le calcul des émissions de carbone, par exemple), PIXGetPowerMetrics doit être appelée directement sur un kit de test XBOX Series S.

Configuration requise

En-tête : pix3.h Bibliothèque : pixevt.lib Plateformes prises en charge : consoles XBOX Series

Voir aussi

PIX3
PIX
PIXPowerMetrics
Last modified on October 6, 2026