Skip to main content
Offre les mêmes fonctionnalités que Wait, mais avec un contrôle supplémentaire sur les composants du processeur de commandes (CP) qui participent à l’attente et sur les vidages de cache associés.

Syntaxe

Paramètres

pFence   _In_
Type : ID3D12Fence*
Pointeur vers l’objet ID3D12Fence. Value   _In_
Type : UINT64
Valeur que la file d’attente de commandes attend que la clôture atteigne ou dépasse. Ainsi, lorsque ID3D12Fence::GetCompletedValue est supérieur ou égal à Value, l’attente prend fin. pSyncTopOfPipeParams   _In_opt_
Type : D3D12XBOX_SYNC_PARAMS*
Ensemble facultatif de directives de synchronisation et de contrôle en haut de pipeline. Les vidages de cache spécifiés sont effectués une fois la condition d’attente satisfaite. Les indicateurs D3D12XBOX_SYNC_CONTROL_FLAG_TOP_SELECT_ENGINE_PFP et D3D12XBOX_SYNC_CONTROL_FLAG_TOP_SELECT_ENGINE_CE peuvent servir à contrôler quels composants du CP participent à l’attente.

Valeur de retour

Type : HRESULT L’un des codes de retour Direct3D 12.

Remarques

Appeler WaitX au lieu de Wait vous permet de contrôler quels composants du CP participent à l’attente et quels vidages de cache sont effectués immédiatement après. Cela peut servir à améliorer les performances. Par exemple, Wait bloque le PFP et le CE jusqu’à ce que la condition d’attente soit satisfaite. Or, il est inutile de bloquer le PFP et le CE, sauf si vous effectuez la transition d’une ressource qui se trouve dans l’état D3D12_RESOURCE_STATE_INDIRECT_ARGS d’une file d’attente de calcul vers une file d’attente directe. Cette fonction permet d’éviter la synchronisation inutile en passant nullptr pour pSyncTopOfPipeParams ou en omettant les indicateurs D3D12XBOX_SYNC_CONTROL_FLAG_TOP_SELECT_ENGINE_PFP et D3D12XBOX_SYNC_CONTROL_FLAG_TOP_SELECT_ENGINE_CE de D3D12XBOX_SYNC_PARAMS::ControlFlags. Pour obtenir des renseignements sur les clôtures, consultez CPU/GPU Synchronization dans Portage de Direct3D 11 vers Direct3D 12.

Configuration requise

En-tête : d3d12_xs.h
Bibliothèque : d3d12_xs.lib
Plateformes prises en charge : consoles XBOX Series

Voir aussi

D3D12_SYNC_CONTROL_FLAGS
Signal2X
SyncBottomOfPipeX
SyncTopOfPipeX
ID3D12CommandQueue
Last modified on October 6, 2026