ID3D12XboxDmaCommandList::Write64BitValueBottomOfPipeX Method

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

Syntax

public:
void Write64BitValueBottomOfPipeX(
         D3D12_GPU_VIRTUAL_ADDRESS Destination,
         UINT64 Value,
         D3D12XBOX_FLUSH Flush,
         D3D12XBOX_WRITE_VALUE_BOP_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 32-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.

Flush
Type: D3D12XBOX_FLUSH

[in] A D3D12XBOX_FLUSH enumeration constant. Must be set to D3D12XBOX_FLUSH_NONE.

Flags
Type: D3D12XBOX_WRITE_VALUE_BOP_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_BOP_FLAGS enumeration constants.

D3D12XBOX_WRITE_VALUE_BOP_FLAG_NONE will select the given Value parameter.
D3D12XBOX_WRITE_VALUE_BOP_FLAG_GPU_TIMESTAMP will select the current GPU clock counter value.
D3D12XBOX_WRITE_VALUE_BOP_FLAG_SYSTEM_TIMESTAMP will select the current system clock counter value.

Return value

Type: void

Returns nothing.

Remarks

When used in conjunction with the method ID3D12XboxDmaCommandList::Wait64BitValueX, Write64BitValueBottomOfPipeX can serve as a useful cross-engine intra-command-list synchronization mechanism.

Requirements

Header: Declared in d3d12_x.h.

Library: Use d3d12_x.lib.