> ## 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 au début du pipeline GPU dans D3D12 X.

Écrit une valeur 32 bits au début du pipeline à 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)

L'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

La valeur 32 bits à écrire.

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

Une combinaison par OU 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'horodatages 64 bits et ne sont donc pris en charge qu'avec [Write64BitValueTopOfPipeX](/fr-CA/reference/graphics/d3d12_x/interfaces/id3d12graphicscommandlist/methods/id3d12graphicscommandlist_write64bitvaluetopofpipex).

### Valeur de retour

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

Lorsqu'elle est utilisée conjointement avec la méthode [Wait32BitValueX](/fr-CA/reference/graphics/d3d12_x/interfaces/id3d12graphicscommandlist/methods/id3d12graphicscommandlist_wait32bitvaluex), **Write32BitValueTopOfPipeX** peut servir de mécanisme utile de synchronisation entre moteurs au sein d'une même 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-CA/reference/graphics/d3d12_x/interfaces/id3d12graphicscommandlist/id3d12graphicscommandlist)\
[Write32BitValueBottomOfPipeX](/fr-CA/reference/graphics/d3d12_x/interfaces/id3d12graphicscommandlist/methods/id3d12graphicscommandlist_write32bitvaluebottomofshaderx)


## Related topics

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