Skip to main content

​
PIXGetPowerMetrics

Retorna a carga de energia atual em consoles XBOX Series.
O valor de carga de energia não é compatível com os consoles da família XBOX One. Nesses consoles, a estrutura PIXPowerMetrics preenchida por PIXGetPowerMetrics sempre conterá um valor de carga de energia igual a 0.
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

​
Parâmetros

metrics
Tipo: PPIXPowerMetrics Um ponteiro para uma estrutura 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 do PIX. Esse valor também é exibido no painel frontal 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
PIX
PIXPowerMetrics
Last modified on October 6, 2026