> ## 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 lê a carga de energia atual da GPU em consoles XBOX Series para que os títulos possam acompanhar e ajustar seu consumo geral de energia durante o jogo.

# PIXGetPowerMetrics

Retorna a carga de energia atual em consoles XBOX Series.

<Note>
  O valor de carga de energia não é compatível com os consoles da família XBOX One.  Nesses consoles, a estrutura [PIXPowerMetrics](/pt-BR/reference/tools/pix3/structs/pixpowermetrics) preenchida por PIXGetPowerMetrics sempre conterá um valor de carga de energia igual a 0.
</Note>

PIXGetPowerMetrics ajuda os desenvolvedores a acompanhar o consumo geral de energia do título. Esta API foi projetada para permitir que os desenvolvedores façam alterações direcionadas, que não são visíveis para o jogador, mas que ajudam a reduzir o uso geral de energia do título em execução no console.

## Sintaxe

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

### Parâmetros

*metrics*   <br />Tipo: PPIXPowerMetrics

Um ponteiro para uma estrutura [PIXPowerMetrics](/pt-BR/reference/tools/pix3/structs/pixpowermetrics).  No retorno, o campo `GpuAvgPowerLoadPct` da estrutura PIXPowerMetrics é preenchido com o valor atual de carga de energia no console.  Em consoles XBOX Series, o valor de carga de energia é uma porcentagem de 0 a 100.  Nos consoles da família XBOX One, o valor de carga de energia sempre será 0.

### Valor retornado

Tipo: HRESULT

## Comentários

O valor de carga de energia retornado por PIXGetPowerMetrics é o mesmo valor relatado pelo contador `Load %` no nó `Power Monitor` do [System Monitor](/pt-BR/tools/tools-console/pix/pix-system-monitor) do PIX.  Esse valor também é exibido no [painel frontal](https://learn.microsoft.com/gaming/gdk/docs/gdk-dev/console-dev/dev-kits/concepts/scorpio-frontpanel) dos XBOX Development Kits.

Ao determinar a carga de energia de um console XBOX Series S,  o valor retornado por PIXGetPowerMetrics durante a execução no `Lockhart profiling mode` em um XBOX Series X Dev Kit pode ser usado para ajustar um título, mas, para obter leituras precisas (para cálculos de emissão de carbono, por exemplo), PIXGetPowerMetrics deve ser chamado diretamente em um XBOX Series S Test Kit.

## Requisitos

**Cabeçalho:** pix3.h

**Biblioteca:** pixevt.lib

**Plataformas compatíveis:** consoles XBOX Series

## Confira também

[PIX3](/pt-BR/reference/tools/pix3/pix3_members)<br />[PIX](/pt-BR/tools/tools-console/pix/pix)<br />[PIXPowerMetrics](/pt-BR/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)