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

語法

參數

Destination   _In_
類型:D3D12_GPU_VIRTUAL_ADDRESS
要寫入值的圖形記憶體基底位址。此位址必須以 4 位元組對齊。 Value   _In_
類型:UINT
要寫入的 32 位元值。 Flags   _In_
類型:D3D12XBOX_WRITE_VALUE_TOP_FLAGS
D3D12XBOX_WRITE_VALUE_TOP_FLAGS 列舉的位元 OR 組合,指定值的寫入方式。D3D12XBOX_WRITE_VALUE_TOP_FLAG_GPU_TIMESTAMP 和 D3D12XBOX_WRITE_VALUE_TOP_FLAG_SYSTEM_TIMESTAMP 旗標會要求 64 位元時間戳記回寫,因此僅支援搭配 Write64BitValueTopOfPipeX 使用。

傳回值

類型:void

備註

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

需求

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

另請參閱

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