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

語法

參數

Destination   _In_
類型:D3D12_GPU_VIRTUAL_ADDRESS
要寫入值的圖形記憶體基底位址。位址必須以 4 位元組對齊。 Value   _In_
類型:UINT64
要寫入指定記憶體位置的 64 位元值。 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 指定使用指定的 Value 參數。
  • D3D12XBOX_WRITE_VALUE_BOP_FLAG_GPU_TIMESTAMP 指定使用目前 GPU 時脈計數器的值。
  • D3D12XBOX_WRITE_VALUE_BOP_FLAG_SYSTEM_TIMESTAMP 指定使用目前系統時脈計數器的值。

傳回值

類型:void 無。

備註

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

需求

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

另請參閱

ID3D12GraphicsCommandList6
d3d12_xs
Last modified on October 6, 2026