Skip to main content
從管線底部將 32 位元值寫入記憶體中的指定目的地。

語法

參數

Destination   _In_
類型:D3D12_GPU_VIRTUAL_ADDRESS
要寫入值的圖形記憶體基底位址。位址必須以 4 位元組對齊。 Value   _In_
類型:UINT
要寫入指定記憶體位置的 32 位元值。 SyncFlags   _In_
類型:D3D12XBOX_SYNC_FLAGS
與寫入作業一起執行的一組選用同步指示詞。旗標可以是下列項目的組合:
  • D3D12XBOX_SYNC_FLAG_VCACHE_INVALIDATE
  • D3D12XBOX_SYNC_FLAG_MCACHE_INVALIDATE
  • D3D12XBOX_SYNC_FLAG_MCACHE_WRITEBACK
  • D3D12XBOX_SYNC_FLAG_GL1_INVALIDATE
  • D3D12XBOX_SYNC_FLAG_GL2_INVALIDATE
  • D3D12XBOX_SYNC_FLAG_GL2_WRITEBACK
  • D3D12XBOX_SYNC_FLAG_GL2_VOLATILE
ControlFlags   _In_
類型:D3D12XBOX_SYNC_CONTROL_FLAGS
要套用於同步作業的一組選用控制修飾詞。旗標可以是下列其中一項:
  • D3D12XBOX_SYNC_CONTROL_FLAG_GCR_SEQUENCE_FORWARD
  • D3D12XBOX_SYNC_CONTROL_FLAG_GCR_SEQUENCE_REVERSE
WriteFlags   _In_
類型:D3D12XBOX_WRITE_VALUE_BOP_FLAGS
D3D12XBOX_WRITE_VALUE_BOP_FLAGS 的位元 OR 組合,用於控制寫入作業。目前必須設為 D3D12XBOX_WRITE_VALUE_BOP_FLAG_NONE。D3D12XBOX_WRITE_VALUE_BOP_FLAG_GPU_TIMESTAMP 和 D3D12XBOX_WRITE_VALUE_BOP_FLAG_SYSTEM_TIMESTAMP 旗標會要求 64 位元時間戳記回寫,且僅受 Write64BitValueBottomOfPipe2X 支援。

傳回值

類型:void 無。

備註

32 位元值會在所有著色器執行與轉譯後端處理完成後寫入記憶體,但可能會在先前繪製與分派所產生的所有記憶體寫入完成之前寫入。 搭配 Wait32BitValueX 方法使用時,Write32BitValueBottomOfPipe2X 可作為實用的跨引擎、命令清單內同步機制。

需求

標頭: d3d12_xs.h
程式庫: d3d12_xs.lib
支援的平台: XBOX Series 主機

另請參閱

ID3D12GraphicsCommandList6
d3d12_xs
Last modified on October 6, 2026