Passer au contenu principal

PIXGetPowerMetrics

Retourne la charge d’alimentation actuelle sur les consoles XBOX Series.
La valeur de charge d’alimentation n’est pas prise en charge sur la famille de consoles XBOX One. Sur ces consoles, la structure PIXPowerMetrics remplie par PIXGetPowerMetrics contiendra toujours une valeur de charge d’alimentation 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 aident à 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 rempli avec la valeur de charge d’alimentation actuelle de la console. Sur les consoles XBOX Series, la valeur de charge d’alimentation est un pourcentage de 0 à 100. Sur la famille de consoles XBOX One, la valeur de charge d’alimentation sera toujours 0.

Valeur de retour

Type : HRESULT

Remarques

La valeur de charge d’alimentation 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 trousses de développement XBOX. Pour déterminer la charge d’alimentation d’une console XBOX Series S, la valeur retournée par PIXGetPowerMetrics lors d’une exécution en Lockhart profiling mode sur une trousse 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 une trousse 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
Dernière modification le 6 octobre 2026