Skip to main content
Grava um valor de 64 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 onde o valor será gravado. O endereço deve estar alinhado a 8 bytes. Value   _In_
Tipo: UINT64
O valor de 64 bits a ser gravado se uma opção de carimbo de data/hora não for selecionada. Se uma opção de carimbo de data/hora for selecionada, o valor deverá ser definido como 0. Flags   _In_
Tipo: D3D12XBOX_WRITE_VALUE_TOP_FLAGS
Combinação OR bit a bit de constantes da enumeração D3D12XBOX_WRITE_VALUE_TOP_FLAGS que especificam o valor gravado na memória. A origem do valor gravado é baseada nas constantes selecionadas:
  • D3D12XBOX_WRITE_VALUE_TOP_FLAG_NONE grava o parâmetro Value especificado.
  • D3D12XBOX_WRITE_VALUE_TOP_FLAG_WAIT_FOR_WRITE_RETURN grava o Value especificado depois que a conclusão das gravações pendentes na memória é confirmada.
  • D3D12XBOX_WRITE_VALUE_TOP_FLAG_SELECT_ENGINE_PFP grava o Value especificado a partir do mecanismo analisador de pré-busca (prefetch-parser). Isso acontece mais cedo do que a seleção a partir do mecanismo padrão.
  • D3D12XBOX_WRITE_VALUE_TOP_FLAG_GPU_TIMESTAMP grava o valor atual do contador de relógio da GPU.
  • D3D12XBOX_WRITE_VALUE_TOP_FLAG_SYSTEM_TIMESTAMP grava o valor atual do contador de relógio do sistema.

Valor retornado

Tipo: void

Comentários

O valor de 64 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 Wait64BitValueX, Write64BitValueTopOfPipeX 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
Write32BitValueTopOfPipeX
Write64BitValueBottomOfPipeX
Last modified on October 6, 2026