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

# WaitX (consoles XBOX Series)

> Offre les mêmes fonctionnalités que Wait(), mais avec un contrôle supplémentaire sur l'attente et les vidages de cache.

Offre les mêmes fonctionnalités que [Wait](https://learn.microsoft.com/en-us/windows/win32/api/d3d12/nf-d3d12-id3d12commandqueue-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

```cpp theme={null}
HRESULT WaitX(
        ID3D12Fence* pFence,
        UINT64 Value,
        D3D12XBOX_SYNC_PARAMS* pSyncTopOfPipeParams)
```

### 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](https://learn.microsoft.com/en-us/windows/win32/api/d3d12/nf-d3d12-id3d12fence-getcompletedvalue)
est supérieur ou égal à Value, l'attente prend fin.

*pSyncTopOfPipeParams*   \_In\_opt\_\
Type : [D3D12XBOX\_SYNC\_PARAMS\*](/fr-CA/reference/graphics/d3d12_xs/structs/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](/fr-CA/reference/graphics/d3d12_xs/enums/d3d12xbox_sync_control_flags) et [D3D12XBOX\_SYNC\_CONTROL\_FLAG\_TOP\_SELECT\_ENGINE\_CE](/fr-CA/reference/graphics/d3d12_xs/enums/d3d12xbox_sync_control_flags)
peuvent servir à contrôler quels composants du CP participent à l'attente.

### Valeur de retour

Type : HRESULT

L'un des [codes de retour Direct3D 12](https://msdn.microsoft.com/library/windows/desktop/dn706075\(v=vs.85\).aspx).

## 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](https://learn.microsoft.com/en-us/windows/win32/api/d3d12/nf-d3d12-id3d12commandqueue-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](/fr-CA/reference/graphics/d3d12_xs/enums/d3d12xbox_sync_control_flags) et [D3D12XBOX\_SYNC\_CONTROL\_FLAG\_TOP\_SELECT\_ENGINE\_CE](/fr-CA/reference/graphics/d3d12_xs/enums/d3d12xbox_sync_control_flags) de
[D3D12XBOX\_SYNC\_PARAMS::ControlFlags](/fr-CA/reference/graphics/d3d12_xs/structs/d3d12xbox_sync_params).

Pour obtenir des renseignements sur les clôtures, consultez **CPU/GPU Synchronization** dans [Portage de Direct3D 11 vers Direct3D 12](https://learn.microsoft.com/en-us/windows/win32/direct3d12/porting-from-direct3d-11-to-direct3d-12#cpugpu-synchronization).

## 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](/fr-CA/reference/graphics/d3d12_xs/enums/d3d12xbox_sync_control_flags)\
[Signal2X](/fr-CA/reference/graphics/d3d12_xs/interfaces/ID3D12CommandQueue/methods/id3d12commandqueue_signal2x)\
[SyncBottomOfPipeX](/fr-CA/reference/graphics/d3d12_xs/interfaces/ID3D12GraphicsCommandList6/methods/id3d12graphicscommandlist6_syncbottomofpipex)\
[SyncTopOfPipeX](/fr-CA/reference/graphics/d3d12_xs/interfaces/ID3D12GraphicsCommandList6/methods/id3d12graphicscommandlist6_synctopofpipex)\
[ID3D12CommandQueue](/fr-CA/reference/graphics/d3d12_x/interfaces/id3d12commandqueue/id3d12commandqueue)


## Related topics

- [Répertoire des rubriques NDA : liens actifs vers Microsoft Learn](/fr-CA/nda/nda-topic-directory.md)
- [D3D12_GLOBAL_BARRIER (XBOX Series consoles)](/reference/graphics/d3d12/structs/d3d12_global_barrier_public.md)
- [D3D12_BUFFER_BARRIER (XBOX Series consoles)](/reference/graphics/d3d12/structs/d3d12_buffer_barrier_public.md)
- [D3D12_TEXTURE_BARRIER (XBOX Series consoles)](/reference/graphics/d3d12/structs/d3d12_texture_barrier_public.md)
- [Barrier (XBOX Series consoles)](/reference/graphics/d3d12/interfaces/id3d12graphicscommandlist7/methods/id3d12graphicscommandlist7_barrier_public.md)