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

語法

參數

Destination   _In_
類型:D3D12_GPU_VIRTUAL_ADDRESS
將寫入值的圖形記憶體基底位址。此位址必須以 8 位元組對齊。 Value   _In_
類型:UINT64
未選取時間戳記選項時要寫入的 64 位元值。如果已選取時間戳記選項,此值必須設為 0。 Flags   _In_
類型:D3D12XBOX_WRITE_VALUE_TOP_FLAGS
D3D12XBOX_WRITE_VALUE_TOP_FLAGS 列舉常數的位元 OR 組合,指定要寫入記憶體的值。寫入值的來源取決於所選取的常數:
  • D3D12XBOX_WRITE_VALUE_TOP_FLAG_NONE 會寫入所指定的 Value 參數。
  • D3D12XBOX_WRITE_VALUE_TOP_FLAG_WAIT_FOR_WRITE_RETURN 會在確認未完成的記憶體寫入皆已完成後,寫入所指定的 Value。
  • D3D12XBOX_WRITE_VALUE_TOP_FLAG_SELECT_ENGINE_PFP 會從預先擷取剖析器引擎寫入所指定的 Value。這比從預設引擎選取更早發生。
  • D3D12XBOX_WRITE_VALUE_TOP_FLAG_GPU_TIMESTAMP 會寫入目前 GPU 時脈計數器的值。
  • D3D12XBOX_WRITE_VALUE_TOP_FLAG_SYSTEM_TIMESTAMP 會寫入目前系統時脈計數器的值。

傳回值

類型:void

備註

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

需求

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

另請參閱

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