Skip to main content

PIXGetPowerMetrics

傳回 XBOX Series 主機上目前的電源負載。
XBOX One 系列主機不支援電源負載值。在這些主機上,由 PIXGetPowerMetrics 填入的 PIXPowerMetrics 結構一律會包含 0 的電源負載值。
PIXGetPowerMetrics 可協助開發人員追蹤其遊戲的整體耗電量。此 API 的設計目的,是讓開發人員能夠進行玩家看不到的針對性變更,以協助降低其遊戲在主機上執行時的整體電力使用量。

語法

參數

metrics
類型:PPIXPowerMetrics
PIXPowerMetrics 結構的指標。傳回時,PIXPowerMetrics 結構的 GpuAvgPowerLoadPct 欄位會填入主機上目前的電源負載值。在 XBOX Series 主機上,電源負載值是 0 到 100 的百分比。在 XBOX One 系列主機上,電源負載值一律為 0。

傳回值

類型:HRESULT

備註

PIXGetPowerMetrics 傳回的電源負載值,與 PIX System Monitor 中 Power Monitor 節點下的 Load % 計數器所報告的值相同。此值也會顯示在 XBOX 開發套件的前面板上。 判斷 XBOX Series S 主機的電源負載時,在 XBOX Series X 開發套件上以 Lockhart profiling mode 執行時 PIXGetPowerMetrics 傳回的值可用於調整遊戲,但若要取得精確的讀數 (例如用於碳排放計算),則應直接在 XBOX Series S 測試套件上呼叫 PIXGetPowerMetrics。

需求

標頭: pix3.h 程式庫: pixevt.lib 支援的平台: XBOX Series 主機

另請參閱

PIX3
PIX
PIXPowerMetrics
Last modified on October 6, 2026