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

# D3D12XboxPutBuffer (XBOX One 系列)

> D3D12XboxPutBuffer (XBOX One 系列主機) — 用於管理將 GPU 命令寫入目前命令緩衝區區段的結構。

用於管理將 GPU 命令寫入目前命令緩衝區區段的結構。

## 語法

```cpp theme={null}
typedef struct D3D12XboxPutBuffer {  
    const UINT32 BiasDwordCount;  
    const UINT32 MakeSpaceDwordCount;  
    UINT32 m_Reserved1[8];  
    D3D12XBOX_PPUT m_pCurrent;  
    D3D12XBOX_PPUT m_pLimit;  
    D3D12XBOX_PPUT m_pLimit_Draw;  
    D3D12XBOX_PPUT m_pLimit_Api;  
    D3D12XBOX_PPUT m_pUnbiasedLimit_Api;  
    UINT32 m_Reserved2[64];  
} D3D12XboxPutBuffer  
```

### 成員

*BiasDwordCount*\
類型: const UINT32

m\_pPutLimit 從真正限制往下偏移的 dword 數目。

*MakeSpaceDwordCount*\
類型: const UINT32

呼叫 MakeSpace 之後可用的最小 dword 數目。

*m\_Reserved1*\
類型: UINT32\[8]

保留空間。

*m\_pCurrent*\
類型: D3D12XBOX\_PPUT

指向目前正在建構之區段中，下一個 GPU 命令將被新增的位置。

*m\_pLimit*\
類型: D3D12XBOX\_PPUT

指向目前區段的結尾，並往下偏移 BiasDwordCount 個 dword。如果 m\_pCurrent \< m\_pLimit，則保證環形緩衝區中至少還剩 66 個 dword 的空間。如果 m\_pCurrent >= m\_pLimit，則必須先呼叫 MakeSpace()，才能新增更多資料。

*m\_pLimit\_Draw*\
類型: D3D12XBOX\_PPUT

與 m\_pLimit 相同，但在 INSTRUMENTED 組建上通常為 null。這可讓 D3D 為 Draw 呼叫新增非內嵌的計時檢測，同時讓所有其他 API 呼叫保持內嵌。

*m\_pLimit\_Api*\
類型: D3D12XBOX\_PPUT

與 m\_pLimit 相同，但在 DEBUG 組建上一律為 null。由於以內嵌方式檢查參數並不實際，內嵌 API 實作會使用此項，讓 D3D 將呼叫移出內嵌，從而執行完整的參數檢查。

*m\_pUnbiasedLimit\_Api*\
類型: D3D12XBOX\_PPUT

與 m\_pLimit\_Api 相同，但不會往下偏移 BiasDwordCount。當封包大小可能超過 BiasDwordCount 個 dword 時，API 呼叫會使用此項。

*m\_Reserved2*\
類型: UINT32\[64]

保留空間。

## 需求

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

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

## 另請參閱

[d3d12\_x](/zh-TW/reference/graphics/d3d12_x/d3d12_x_members)


## Related topics

- [NDA 主題目錄 - Microsoft Learn 線上連結](/zh-TW/nda/nda-topic-directory.md)
- [D3D12_BUFFER_RTV](/zh-CN/reference/graphics/d3d12/structs/d3d12_buffer_rtv_public.md)
- [D3D12_BUFFER_SRV](/zh-CN/reference/graphics/d3d12/structs/d3d12_buffer_srv_public.md)
- [D3D12_BUFFER_UAV](/zh-CN/reference/graphics/d3d12/structs/d3d12_buffer_uav_public.md)
- [D3D12_VERTEX_BUFFER_VIEW](/zh-CN/reference/graphics/d3d12/structs/d3d12_vertex_buffer_view_public.md)