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

# WriteBufferImmediate

> 直接從命令串流將若干 32 位元立即值寫入指定的緩衝區位置。(ID3D12GraphicsCommandList2.WriteBufferImmediate)

直接從命令串流將若干 32 位元立即值寫入指定的緩衝區位置。

## 語法

```cpp theme={null}
void WriteBufferImmediate(
    UINT Count,
    const D3D12_WRITEBUFFERIMMEDIATE_PARAMETER  pParams,
    const D3D12_WRITEBUFFERIMMEDIATE_MODE  pModes
)
```

### 參數

*Count*\
類型：UINT

<i>pParams</i> 與 <i>pModes</i> 所指向的 [D3D12\_WRITEBUFFERIMMEDIATE\_PARAMETER](/zh-TW/reference/graphics/d3d12/structs/d3d12_writebufferimmediate_parameter_public) 結構數目。

*pParams \[in]*\
類型：const D3D12\_WRITEBUFFERIMMEDIATE\_PARAMETER \*

陣列的位址，該陣列包含數目等於 <i>Count</i> 的 [D3D12\_WRITEBUFFERIMMEDIATE\_PARAMETER](/zh-TW/reference/graphics/d3d12/structs/d3d12_writebufferimmediate_parameter_public) 結構。

*pModes \[in, optional]*\
類型：const D3D12\_WRITEBUFFERIMMEDIATE\_MODE \*

陣列的位址，該陣列包含數目等於 <i>Count</i> 的 [D3D12\_WRITEBUFFERIMMEDIATE\_MODE](/zh-TW/reference/graphics/d3d12/enums/d3d12_writebufferimmediate_mode_public) 結構。預設值為 **null**；傳入 **null** 會使系統使用 **D3D12\_WRITEBUFFERIMMEDIATE\_MODE\_DEFAULT** 寫入所有立即值。

### 傳回值

類型：void

無。

## 備註

**WriteBufferImmediate** 會執行 <i>Count</i> 次 32 位元寫入：<i>pParams</i> 中指定的每個值與目的地各一次。

接收端緩衝區 (資源) 必須處於 **D3D12\_RESOURCE\_STATE\_COPY\_DEST** 狀態，才能成為 **WriteBufferImmediate** 的有效目的地。

## 需求

**標頭:** d3d12\_xs.h 或 d3d12\_x.h\
**程式庫:** d3d12\_xs.lib 或 d3d12\_x.lib\
**支援的平台**: XBOX Series 主機與 XBOX One 系列

## 另請參閱

[ID3D12GraphicsCommandList2](/zh-TW/reference/graphics/d3d12_x/interfaces/ID3D12GraphicsCommandList2/id3d12graphicscommandlist2)


## Related topics

- [D3D12_WRITEBUFFERIMMEDIATE_MODE](/zh-TW/reference/graphics/d3d12/enums/d3d12_writebufferimmediate_mode_public.md)
- [D3D12_WRITEBUFFERIMMEDIATE_PARAMETER](/zh-TW/reference/graphics/d3d12/structs/d3d12_writebufferimmediate_parameter_public.md)
- [GetShapePcmLoopStartOrWritePointer](/zh-TW/reference/audio/shapepcmcontext/functions/getshapepcmloopstartorwritepointer.md)
- [SetShapePcmLoopStartOrWritePointer](/zh-TW/reference/audio/shapepcmcontext/functions/setshapepcmloopstartorwritepointer.md)
- [GetShapeXmaOutputBufferWriteOffset](/zh-TW/reference/audio/shapexmacontext/functions/getshapexmaoutputbufferwriteoffset.md)