語法
參數
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 系列另請參閱
ID3D12GraphicsCommandListWrite32BitValueTopOfPipeX
Write64BitValueBottomOfPipeX
