跳轉到主要內容
在管線底部將 64 位元值寫入記憶體中的指定目的地。

語法

參數

Destination   _In_
類型:D3D12_GPU_VIRTUAL_ADDRESS
要寫入值的圖形記憶體基底位址。此位址必須以 8 位元組對齊。 Value   _In_
類型:UINT64
未選取時間戳記選項時要寫入的 64 位元值。如果已選取時間戳記選項,此值必須設為 0。 Flush   _In_
類型:D3D12XBOX_FLUSH
D3D12XBOX_FLUSH 列舉常數的位元 OR 組合,控制寫入作業期間紋理快取的失效方式。支援的旗標如下:
  • D3D12XBOX_FLUSH_BOP_TEXTURE_L1_INVALIDATE
  • D3D12XBOX_FLUSH_BOP_TEXTURE_L1_VOLATILE
  • D3D12XBOX_FLUSH_BOP_TEXTURE_L2_INVALIDATE
  • D3D12XBOX_FLUSH_BOP_TEXTURE_L2_VOLATILE
  • D3D12XBOX_FLUSH_BOP_TEXTURE_L2_WRITEBACK
Flags   _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 方法使用時,Write64BitValueBottomOfPipeX 可作為實用的跨引擎、命令清單內同步處理機制。

需求

標頭: d3d12_x.h 程式庫: d3d12_x.lib 支援的平台: XBOX One 系列

另請參閱

ID3D12GraphicsCommandList
Write64BitValueTopOfPipeX
最後修改於 2026年10月6日