> ## Documentation Index
> Fetch the complete documentation index at: https://devdocs.xbox.com/llms.txt
> Use this file to discover all available pages before exploring further.

# PIXGetPowerMetrics

> PIXGetPowerMetrics lit la charge énergétique actuelle du GPU sur les consoles XBOX Series afin que les titres puissent suivre et ajuster leur consommation d'énergie globale pendant le jeu.

# PIXGetPowerMetrics

Retourne la charge énergétique actuelle sur les consoles XBOX Series.

<Note>
  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](/fr/reference/tools/pix3/structs/pixpowermetrics) renseignée par PIXGetPowerMetrics contiendra toujours une valeur de charge énergétique de 0.
</Note>

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

```cpp theme={null}
HRESULT PIXGetPowerMetrics(PPIXPowerMetrics metrics)
```

### Paramètres

*metrics*   <br />Type : PPIXPowerMetrics

Pointeur vers une structure [PIXPowerMetrics](/fr/reference/tools/pix3/structs/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](/fr/tools/tools-console/pix/pix-system-monitor) de PIX.  Cette valeur est également affichée sur le [panneau avant](https://learn.microsoft.com/gaming/gdk/docs/gdk-dev/console-dev/dev-kits/concepts/scorpio-frontpanel) 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](/fr/reference/tools/pix3/pix3_members)<br />[PIX](/fr/tools/tools-console/pix/pix)<br />[PIXPowerMetrics](/fr/reference/tools/pix3/structs/pixpowermetrics)


## Related topics

- [Measure power consumption with your devkit](/build/game-principles/sustainability/sustainability-devkit-guide.md)
- [PIX3](/reference/tools/pix3/pix3_members.md)
- [Call of Duty: Modern Warfare II & Warzone case study](/build/game-principles/sustainability/case-studies/case-studies-cod.md)
- [《使命召唤：现代战争 II》与《Warzone》案例研究](/zh-CN/build/game-principles/sustainability/case-studies/case-studies-cod.md)
- [Caso práctico de Call of Duty: Modern Warfare II y Warzone](/es/build/game-principles/sustainability/case-studies/case-studies-cod.md)