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

> Écrit une valeur 64 bits au début du pipeline à une destination spécifiée en mémoire.

Écrit une valeur 64 bits au début du pipeline à une destination spécifiée en mémoire.

## Syntaxe

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

### Paramètres

*Destination*   \_In\_\
Type : D3D12\_GPU\_VIRTUAL\_ADDRESS

L'adresse de base de la mémoire graphique où la valeur sera écrite. L'adresse doit être alignée sur 8 octets.

*Value*   \_In\_\
Type : UINT64

La valeur 64 bits à écrire si aucune option d'horodatage n'est sélectionnée. Si une option d'horodatage est sélectionnée, la valeur doit être définie à 0.

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

Combinaison par OU au niveau du bit de constantes d'énumération **D3D12XBOX\_WRITE\_VALUE\_TOP\_FLAGS** qui spécifient la valeur écrite en mémoire. La source de la valeur écrite dépend des constantes sélectionnées :

* **D3D12XBOX\_WRITE\_VALUE\_TOP\_FLAG\_NONE** écrit le paramètre *Value* spécifié.
* **D3D12XBOX\_WRITE\_VALUE\_TOP\_FLAG\_WAIT\_FOR\_WRITE\_RETURN** écrit la valeur *Value* spécifiée une fois que l'achèvement des écritures en mémoire en attente est confirmé.
* **D3D12XBOX\_WRITE\_VALUE\_TOP\_FLAG\_SELECT\_ENGINE\_PFP** écrit la valeur *Value* spécifiée à partir du moteur d'analyse de prélecture (prefetch-parser). Cela se produit plus tôt qu'avec la sélection du moteur par défaut.
* **D3D12XBOX\_WRITE\_VALUE\_TOP\_FLAG\_GPU\_TIMESTAMP** écrit la valeur actuelle du compteur d'horloge du GPU.
* **D3D12XBOX\_WRITE\_VALUE\_TOP\_FLAG\_SYSTEM\_TIMESTAMP** écrit la valeur actuelle du compteur d'horloge du système.

### Valeur de retour

Type : void

## Remarques

La valeur 64 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 [Wait64BitValueX](/fr-CA/reference/graphics/d3d12_x/interfaces/id3d12graphicscommandlist/methods/id3d12graphicscommandlist_wait64bitvaluex), **Write64BitValueTopOfPipeX** 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)\
[Write32BitValueTopOfPipeX](/fr-CA/reference/graphics/d3d12_x/interfaces/id3d12graphicscommandlist/methods/id3d12graphicscommandlist_write32bitvaluetopofpipex)\
[Write64BitValueBottomOfPipeX](/fr-CA/reference/graphics/d3d12_x/interfaces/id3d12graphicscommandlist/methods/id3d12graphicscommandlist_write64bitvaluebottomofpipex)


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