Skip to main content
Grava um valor de 32 bits no topo do pipeline em um destino especificado na memória.

Sintaxe

Parâmetros

Destination   _In_
Tipo: D3D12_GPU_VIRTUAL_ADDRESS
O endereço base da memória gráfica no qual o valor será gravado. O endereço deve estar alinhado a 4 bytes. Value   _In_
Tipo: UINT
O valor de 32 bits a ser gravado. Flags   _In_
Tipo: D3D12XBOX_WRITE_VALUE_TOP_FLAGS
Uma combinação OR bit a bit da enumeração D3D12XBOX_WRITE_VALUE_TOP_FLAGS que especifica como o valor é gravado. Os sinalizadores D3D12XBOX_WRITE_VALUE_TOP_FLAG_GPU_TIMESTAMP e D3D12XBOX_WRITE_VALUE_TOP_FLAG_SYSTEM_TIMESTAMP solicitam gravações de carimbo de data/hora de 64 bits e, portanto, têm suporte apenas com Write64BitValueTopOfPipeX.

Valor retornado

Tipo: void

Comentários

O valor de 32 bits é gravado na memória após a conclusão de toda a execução de sombreadores e do processamento do back-end de renderização. Geralmente, o valor é gravado antes da conclusão de todas as gravações de memória geradas por desenhos e despachos anteriores. Quando usado em conjunto com o método Wait32BitValueX, Write32BitValueTopOfPipeX pode servir como um mecanismo útil de sincronização entre mecanismos e dentro da lista de comandos.

Requisitos

Cabeçalho: d3d12_x.h Biblioteca: d3d12_x.lib Plataformas com suporte: família XBOX One

Confira também

ID3D12GraphicsCommandList
Write32BitValueBottomOfPipeX
Last modified on October 6, 2026