ID3D12GraphicsCommandList::Write64BitValueTopOfPipeX Method

Writes a 64-bit value at the top of the pipeline to a given destination in memory.

Syntax

public:
void D3DAPI Write64BitValueTopOfPipeX(
         D3D12_GPU_VIRTUAL_ADDRESS Destination,
         UINT64 Value,
         D3D12XBOX_WRITE_VALUE_TOP_FLAGS Flags
)  

Parameters

Destination
Type: D3D12_GPU_VIRTUAL_ADDRESS 

[in] The base address of graphics memory at which to write the value. The address must be 8-byte aligned.

Value
Type: UINT64 

[in] The 64 bit value to be written if a timestamp option has not been selected. When a timestamp has been selected, the value must be set to 0.

Flags
Type: D3D12XBOX_WRITE_VALUE_TOP_FLAGS 

[in] A set of optional flags to select the type of value to be written to memory, as a bitwise-OR’d combination of D3D12XBOX_WRITE_VALUE_TOP_FLAGS enumeration constants.

• D3D12XBOX_WRITE_VALUE_TOP_FLAG_NONE will select the given Value parameter.
• D3D12XBOX_WRITE_VALUE_TOP_FLAG_WAIT_FOR_WRITE_RETURN will select the given Value after confirming that outstanding writes to memory have completed.
• D3D12XBOX_WRITE_VALUE_TOP_FLAG_SELECT_ENGINE_PFP will select the given Value from the prefect-parser engine, which happens sooner than from the default engine.
• D3D12XBOX_WRITE_VALUE_TOP_FLAG_GPU_TIMESTAMP will select the current GPU clock counter value.
• D3D12XBOX_WRITE_VALUE_TOP_FLAG_SYSTEM_TIMESTAMP will select the current system clock counter value.

Return value

Type: void D3DAPI 

Returns nothing.

Requirements

Header: Declared in d3d12_x.h.

Library: Use d3d12_x.lib.