> ## 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.

# Write32BitValueTopOfPipeX (família XBOX One)

> Referência do método ID3D12GraphicsCommandList::Write32BitValueTopOfPipeX, que grava um valor de 32 bits no topo do pipeline da GPU no D3D12 X.

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

## Sintaxe

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

### Parâmetros

*Destination*   \_In\_\
Tipo: [D3D12\_GPU\_VIRTUAL\_ADDRESS](https://learn.microsoft.com/en-us/windows/win32/direct3d12/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](/pt-BR/reference/graphics/d3d12_x/enums/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](/pt-BR/reference/graphics/d3d12_x/interfaces/id3d12graphicscommandlist/methods/id3d12graphicscommandlist_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](/pt-BR/reference/graphics/d3d12_x/interfaces/id3d12graphicscommandlist/methods/id3d12graphicscommandlist_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](/pt-BR/reference/graphics/d3d12_x/interfaces/id3d12graphicscommandlist/id3d12graphicscommandlist)\
[Write32BitValueBottomOfPipeX](/pt-BR/reference/graphics/d3d12_x/interfaces/id3d12graphicscommandlist/methods/id3d12graphicscommandlist_write32bitvaluebottomofshaderx)


## 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)