> ## Documentation Index
> Fetch the complete documentation index at: https://devdocs.xbox.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Write64BitValueTopOfPipeX (família XBOX One)

> Grava um valor de 64 bits no topo do pipeline em um destino especificado na memória.

Grava um valor de 64 bits no topo do pipeline em um destino especificado na memória.

## Sintaxe

```cpp theme={null}
void Write64BitValueTopOfPipeX(  
         D3D12_GPU_VIRTUAL_ADDRESS Destination,  
         UINT64 Value,  
         D3D12XBOX_WRITE_VALUE_TOP_FLAGS Flags  
)  
```

### 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](/pt-BR/reference/graphics/d3d12_x/enums/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](/pt-BR/reference/graphics/d3d12_x/interfaces/id3d12graphicscommandlist/methods/id3d12graphicscommandlist_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](/pt-BR/reference/graphics/d3d12_x/interfaces/id3d12graphicscommandlist/id3d12graphicscommandlist)\
[Write32BitValueTopOfPipeX](/pt-BR/reference/graphics/d3d12_x/interfaces/id3d12graphicscommandlist/methods/id3d12graphicscommandlist_write32bitvaluetopofpipex)\
[Write64BitValueBottomOfPipeX](/pt-BR/reference/graphics/d3d12_x/interfaces/id3d12graphicscommandlist/methods/id3d12graphicscommandlist_write64bitvaluebottomofpipex)


## Related topics

- [Diretório de tópicos NDA: links ativos do Microsoft Learn](/pt-BR/nda/nda-topic-directory.md)
- [GetXmaFrameLengthInBits](/pt-BR/reference/audio/xma2defs/functions/getxmaframelengthinbits.md)
- [GetXmaFrameBitPosition](/pt-BR/reference/audio/xma2defs/functions/getxmaframebitposition.md)
- [Índice de tópicos sob NDA para desenvolvimento de console com o XBOX GDK](/pt-BR/nda/nda-overview.md)
- [GetLastXmaFrameBitPosition](/pt-BR/reference/audio/xma2defs/functions/getlastxmaframebitposition.md)