ID3D12GraphicsCommandList2::WriteBufferImmediate method (d3d12.h)

Writes a number of 32-bit immediate values to the specified buffer locations directly from the command stream.


void WriteBufferImmediate(
                 UINT                                       Count,
  [in]           const D3D12_WRITEBUFFERIMMEDIATE_PARAMETER *pParams,
  [in, optional] const D3D12_WRITEBUFFERIMMEDIATE_MODE      *pModes



The number of D3D12_WRITEBUFFERIMMEDIATE_PARAMETER structures that are pointed to by pParams and pModes.

[in] pParams

The address of an array containing a number of D3D12_WRITEBUFFERIMMEDIATE_PARAMETER structures equal to Count.

[in, optional] pModes

The address of an array containing a number of D3D12_WRITEBUFFERIMMEDIATE_MODE structures equal to Count. The default value is null; passing null causes the system to write all immediate values using D3D12_WRITEBUFFERIMMEDIATE_MODE_DEFAULT.

Return value



WriteBufferImmediate performs Count number of 32-bit writes: one for each value and destination specified in pParams.

The receiving buffer (resource) must be in the D3D12_RESOURCE_STATE_COPY_DEST state to be a valid destination for WriteBufferImmediate.


Requirement Value
Minimum supported client Windows 10 [desktop apps only]
Minimum supported server Windows Server 2016 [desktop apps only]
Target Platform Windows
Header d3d12.h
Library D3D12.lib
DLL D3D12.dll

See also