> ## 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 (famille XBOX One)

> Référence de la méthode ID3D12GraphicsCommandList::Write32BitValueTopOfPipeX, qui écrit une valeur 32 bits en haut du pipeline GPU dans D3D12 X.

Écrit une valeur 32 bits en haut du pipeline vers une destination spécifiée en mémoire.

## Syntaxe

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

### Paramètres

*Destination*   \_In\_\
Type : [D3D12\_GPU\_VIRTUAL\_ADDRESS](https://learn.microsoft.com/en-us/windows/win32/direct3d12/d3d12_gpu_virtual_address)

Adresse de base de la mémoire graphique à laquelle écrire la valeur. L'adresse doit être alignée sur 4 octets.

*Value*   \_In\_\
Type : UINT

Valeur 32 bits à écrire.

*Flags*   \_In\_\
Type : [D3D12XBOX\_WRITE\_VALUE\_TOP\_FLAGS](/fr/reference/graphics/d3d12_x/enums/d3d12xbox_write_value_top_flags)

Combinaison d'opérations OR au niveau du bit de l'énumération **D3D12XBOX\_WRITE\_VALUE\_TOP\_FLAGS** qui spécifie la façon dont la valeur est écrite. Les indicateurs **D3D12XBOX\_WRITE\_VALUE\_TOP\_FLAG\_GPU\_TIMESTAMP** et **D3D12XBOX\_WRITE\_VALUE\_TOP\_FLAG\_SYSTEM\_TIMESTAMP** demandent des réécritures d'horodatage 64 bits et ne sont donc pris en charge qu'avec [Write64BitValueTopOfPipeX](/fr/reference/graphics/d3d12_x/interfaces/id3d12graphicscommandlist/methods/id3d12graphicscommandlist_write64bitvaluetopofpipex).

### Valeur renvoyée

Type : void

## Remarques

La valeur 32 bits est écrite en mémoire après la fin de toute l'exécution des nuanceurs et du traitement back-end de rendu. La valeur est généralement écrite avant la fin de toutes les écritures en mémoire générées par les dessins et les distributions précédents.

Utilisée conjointement avec la méthode [Wait32BitValueX](/fr/reference/graphics/d3d12_x/interfaces/id3d12graphicscommandlist/methods/id3d12graphicscommandlist_wait32bitvaluex), **Write32BitValueTopOfPipeX** peut servir de mécanisme de synchronisation utile entre moteurs, au sein d'une liste de commandes.

## Configuration requise

**En-tête :** d3d12\_x.h

**Bibliothèque :** d3d12\_x.lib

**Plateformes prises en charge :** famille XBOX One

## Voir aussi

[ID3D12GraphicsCommandList](/fr/reference/graphics/d3d12_x/interfaces/id3d12graphicscommandlist/id3d12graphicscommandlist)\
[Write32BitValueBottomOfPipeX](/fr/reference/graphics/d3d12_x/interfaces/id3d12graphicscommandlist/methods/id3d12graphicscommandlist_write32bitvaluebottomofshaderx)


## Related topics

- [Répertoire des rubriques NDA : liens actifs vers Microsoft Learn](/fr/nda/nda-topic-directory.md)
- [GetXmaFrameBitPosition](/fr/reference/audio/xma2defs/functions/getxmaframebitposition.md)
- [GetXmaFrameLengthInBits](/fr/reference/audio/xma2defs/functions/getxmaframelengthinbits.md)
- [GetLastXmaFrameBitPosition](/fr/reference/audio/xma2defs/functions/getlastxmaframebitposition.md)
- [SetComputeRoot32BitConstants](/fr/reference/graphics/d3d12/interfaces/id3d12graphicscommandlist/methods/id3d12graphicscommandlist_setcomputeroot32bitconstants_public.md)