Skip to main content
Écrit une valeur 64 bits en haut du pipeline vers une destination spécifiée en mémoire.

Syntaxe

Paramètres

Destination   _In_
Type : D3D12_GPU_VIRTUAL_ADDRESS
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
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 sur 0. Flags   _In_
Type : D3D12XBOX_WRITE_VALUE_TOP_FLAGS
Combinaison d’opérations OR 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 l’achèvement des écritures en mémoire en attente confirmé.
  • D3D12XBOX_WRITE_VALUE_TOP_FLAG_SELECT_ENGINE_PFP écrit la valeur Value spécifiée depuis le moteur d’analyse de prérécupération (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 système.

Valeur renvoyée

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 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 Wait64BitValueX, Write64BitValueTopOfPipeX 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
Write32BitValueTopOfPipeX
Write64BitValueBottomOfPipeX
Last modified on October 6, 2026