> ## 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_PRT_LOD_REPORT_DESC (XBOX Series 主機)

> D3D12XBOX_PRT_LOD_REPORT_DESC (XBOX Series 主機) — 指定 GPU 所寫入之 PRT LOD 報告的目的地記憶體位置和大小，以及。

指定 GPU 所寫入之 PRT LOD 報告的目的地記憶體位置和大小，以及控制在產生報告時如何重設樣本計數器的參數。

## 語法

```cpp theme={null}
struct D3D12XBOX_PRT_LOD_REPORT_DESC
{
    UINT DestinationSizeBytes;
    D3D12_GPU_VIRTUAL_ADDRESS DestinationAddress;

    union
    {
        struct
        {
            UINT : 2;
            UINT ReportingInterval : 8;
            UINT ResetCount : 8;
            UINT ForceReset : 1;
            UINT ReportAndReset : 1;
            UINT : 12;
        };

        UINT Parameters;
    };
};
```

### 成員

*DestinationSizeBytes*\
類型：UINT

報告緩衝區的大小 (以位元組為單位)。大小必須符合公式 N \* 2 KB + 64 位元組，其中 N 至少為 2。N 的值定義多重緩衝的數量 (也就是 N 為 2 表示雙重緩衝，N 為 3 表示三重緩衝)。

*DestinationAddress*\
類型：D3D12\_GPU\_VIRTUAL\_ADDRESS

報告記憶體的圖形虛擬位址。此值必須以 64 位元組對齊。建議將 PRT LOD 報告放在專為 CPU 回讀而設計的圖形記憶體類型中，例如 XALLOC\_MEMTYPE\_GRAPHICS\_CACHEABLE 或 XALLOC\_MEMTYPE\_GRAPHICS\_GPU\_UNCACHED。

*ReportingInterval*\
類型：UINT

非零值會啟用以計時器為基礎的自動報告產生。如果此值不為零，PRT LOD 硬體就會以固定間隔自動產生報告，此間隔由 ReportingInterval 乘以 100,000 個時脈週期定義。

*ResetCount*\
類型：UINT

在不重設計數器的情況下擷取的樣本數。\
0 - 每個樣本都重設。\
1-255 - 不重設的樣本數。

*ForceReset*\
類型：UINT

在下一個樣本時重設硬體中的計數器。

*ReportAndReset*\
類型：UINT

觸發報告並重設計數器。
若已設定，只有在 ReportingInterval == 0 時，才會觸發重設並使計數器複製到記憶體緩衝區中的下一個位置；否則會忽略此值。

## 備註

此結構是 [ID3D12GraphicsCommandList6::WritePRTLODStatisticsX](/zh-TW/reference/graphics/d3d12_xs/interfaces/ID3D12GraphicsCommandList6/methods/id3d12graphicscommandlist6_writeprtlodstatisticsx) API 的輸入。

## 需求

**標頭：** d3d12\_xs.h\
**支援的平台**：XBOX Series 主機

## 另請參閱

[ID3D12GraphicsCommandList6::WritePRTLODStatisticsX](/zh-TW/reference/graphics/d3d12_xs/interfaces/ID3D12GraphicsCommandList6/methods/id3d12graphicscommandlist6_writeprtlodstatisticsx)\
[d3d12\_xs](/zh-TW/reference/graphics/d3d12_xs/d3d12_xs_members)


## Related topics

- [NDA 토픽 디렉터리 - Microsoft Learn 라이브 링크](/ko/nda/nda-topic-directory.md)
- [Répertoire des rubriques NDA : liens actifs vers Microsoft Learn](/fr-CA/nda/nda-topic-directory.md)
- [Diretório de tópicos NDA: links ativos do Microsoft Learn](/pt-BR/nda/nda-topic-directory.md)
- [NDA topic directory - live Microsoft Learn links](/nda/nda-topic-directory.md)
- [Directorio de temas NDA: enlaces activos a Microsoft Learn](/es/nda/nda-topic-directory.md)