> ## 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.

# D3D12XBOX_PRESENT_STATISTICS (XBOX One 系列)

> 定義與畫面格呈現相關的統計資料。

定義與畫面格呈現相關的統計資料。

## 語法

```cpp theme={null}
typedef struct D3D12XBOX_PRESENT_STATISTICS
{
    UINT8 PlaneIndex;
    UINT8 PlaneCount;
    UINT8 ViewCount;
    UINT64 PresentCallTime;
    UINT64 PresentQueueTime;
    UINT64 GPUProcessTime;
    UINT8 QueuedFrameCount;
    UINT16 PlaneSwapMask;
} D3D12XBOX_PRESENT_STATISTICS;
```

### 成員

*PlaneIndex*\
類型：UINT8

用來呈現畫面格的平面索引。系統會針對 [PresentX](/zh-TW/reference/graphics/d3d12_x/interfaces/id3d12commandqueue/methods/id3d12commandqueue_presentx) 中包含的每個平面回報個別的呈現統計資料。

*PlaneCount*\
類型：UINT8

用來呈現畫面格的平面數目：也就是針對該畫面格傳遞給 [PresentX](/zh-TW/reference/graphics/d3d12_x/interfaces/id3d12commandqueue/methods/id3d12commandqueue_presentx) 的 *PlaneCount* 參數。

*ViewCount*\
類型：UINT8

用來呈現畫面格的檢視數目：也就是針對該畫面格傳遞給 [PresentX](/zh-TW/reference/graphics/d3d12_x/interfaces/id3d12commandqueue/methods/id3d12commandqueue_presentx) 的 *ViewCount* 參數。

*PresentCallTime*\
類型：UINT64

畫面格首次出現在平面上之 [PresentX](/zh-TW/reference/graphics/d3d12_x/interfaces/id3d12commandqueue/methods/id3d12commandqueue_presentx) 呼叫的時間戳記 (以 *QueryPerformanceCounter* 為基礎)。為了在相關聯平面上繼續顯示該畫面格而參考它的重複呼叫，將不會被回報。

*PresentQueueTime*\
類型：UINT64

畫面格加入內部呈現佇列的時間。

*GPUProcessTime*\
類型：UINT64

發出 [PresentX](/zh-TW/reference/graphics/d3d12_x/interfaces/id3d12commandqueue/methods/id3d12commandqueue_presentx) 的 GPU 命令佇列到達呈現命令並加以處理的時間。

*QueuedFrameCount*\
類型：UINT8

指出呼叫 [PresentX](/zh-TW/reference/graphics/d3d12_x/interfaces/id3d12commandqueue/methods/id3d12commandqueue_presentx) 時呈現佇列的積壓或清空程度。如果有等待，此值回報的是等待之後而非之前的時間。

*PlaneSwapMask*\
類型：UINT16

回報呈現中與前一次呼叫 [PresentX](/zh-TW/reference/graphics/d3d12_x/interfaces/id3d12commandqueue/methods/id3d12commandqueue_presentx) 時平面上所顯示資源不同的平面資源。值為 1 表示因呈現而將要或已經翻轉到顯示器的平面，值為 0 表示將繼續顯示的平面。遮罩中的 LSB 對應到平面 0，各平面依位元重要性遞增的順序排列。

## 需求

**標頭：** d3d12\_x.h

**支援的平台：** XBOX One 系列

## 另請參閱

[D3D12XBOX\_FRAME\_STATISTICS](/zh-TW/reference/graphics/d3d12_x/structs/d3d12xbox_frame_statistics)\
[ID3D12Device::GetFrameStatisticsX](/zh-TW/reference/graphics/d3d12_x/interfaces/id3d12device/methods/id3d12device_getframestatisticsx)


## Related topics

- [NDA 主題目錄 - Microsoft Learn 線上連結](/zh-TW/nda/nda-topic-directory.md)
- [NDA topic directory - live Microsoft Learn links](/nda/nda-topic-directory.md)
- [NDA 主题目录 - Microsoft Learn 在线链接](/zh-CN/nda/nda-topic-directory.md)
- [Diretório de tópicos NDA: links ativos do Microsoft Learn](/pt-BR/nda/nda-topic-directory.md)
- [Répertoire des rubriques NDA : liens actifs vers Microsoft Learn](/fr/nda/nda-topic-directory.md)