> ## 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](/reference/graphics/d3d12/structs/d3d12_writebufferimmediate_parameter_public) 结构的数量。

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

包含数量等于 <i>Count</i> 的 [D3D12\_WRITEBUFFERIMMEDIATE\_PARAMETER](/reference/graphics/d3d12/structs/d3d12_writebufferimmediate_parameter_public) 结构的数组的地址。

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

包含数量等于 <i>Count</i> 的 [D3D12\_WRITEBUFFERIMMEDIATE\_MODE](/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](/reference/graphics/d3d12_x/interfaces/ID3D12GraphicsCommandList2/id3d12graphicscommandlist2)


## Related topics

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