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

> Fornece a mesma funcionalidade que Wait(), mas com controle adicional sobre a espera e as liberações de cache.

Fornece a mesma funcionalidade que [Wait](https://learn.microsoft.com/en-us/windows/win32/api/d3d12/nf-d3d12-id3d12commandqueue-wait), mas com controle adicional sobre quais componentes do processador de comandos (CP)
participam da espera e sobre quaisquer liberações de cache associadas.

## Sintaxe

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

### Parâmetros

*pFence*   \_In\_\
Tipo: ID3D12Fence\*

Um ponteiro para o objeto ID3D12Fence.

*Value*   \_In\_\
Tipo: UINT64

O valor que a fila de comandos aguarda que a barreira alcance ou exceda. Assim, quando [ID3D12Fence::GetCompletedValue](https://learn.microsoft.com/en-us/windows/win32/api/d3d12/nf-d3d12-id3d12fence-getcompletedvalue)
for maior ou igual a Value, a espera será encerrada.

*pSyncTopOfPipeParams*   \_In\_opt\_\
Tipo: [D3D12XBOX\_SYNC\_PARAMS\*](/pt-BR/reference/graphics/d3d12_xs/structs/d3d12xbox_sync_params)

Um conjunto opcional de diretivas de sincronização e controle de início de pipeline (top-of-pipe). Todas as liberações de cache especificadas são executadas depois que a condição de espera é atendida. Os sinalizadores
[D3D12XBOX\_SYNC\_CONTROL\_FLAG\_TOP\_SELECT\_ENGINE\_PFP](/pt-BR/reference/graphics/d3d12_xs/enums/d3d12xbox_sync_control_flags) e [D3D12XBOX\_SYNC\_CONTROL\_FLAG\_TOP\_SELECT\_ENGINE\_CE](/pt-BR/reference/graphics/d3d12_xs/enums/d3d12xbox_sync_control_flags)
podem ser usados para controlar quais componentes do CP participam da espera.

### Valor retornado

Tipo: HRESULT

Um dos [códigos de retorno do Direct3D 12](https://msdn.microsoft.com/library/windows/desktop/dn706075\(v=vs.85\).aspx).

## Comentários

Chamar **WaitX** em vez de **Wait** dá a você controle sobre quais componentes do CP participam da espera e quais liberações de cache são executadas imediatamente em seguida. Isso pode ser usado para melhorar o desempenho. Por exemplo,
[Wait](https://learn.microsoft.com/en-us/windows/win32/api/d3d12/nf-d3d12-id3d12commandqueue-wait) fará com que o PFP e o CE fiquem bloqueados até que a condição de espera seja atendida. No entanto, não é necessário bloquear o PFP e o CE, a menos que
você esteja fazendo a transição de um recurso que está no estado D3D12\_RESOURCE\_STATE\_INDIRECT\_ARGS de uma fila de computação para uma fila direta. A sincronização desnecessária pode ser evitada com esta função passando nullptr para
pSyncTopOfPipeParams ou omitindo os sinalizadores [D3D12XBOX\_SYNC\_CONTROL\_FLAG\_TOP\_SELECT\_ENGINE\_PFP](/pt-BR/reference/graphics/d3d12_xs/enums/d3d12xbox_sync_control_flags) e [D3D12XBOX\_SYNC\_CONTROL\_FLAG\_TOP\_SELECT\_ENGINE\_CE](/pt-BR/reference/graphics/d3d12_xs/enums/d3d12xbox_sync_control_flags) de
[D3D12XBOX\_SYNC\_PARAMS::ControlFlags](/pt-BR/reference/graphics/d3d12_xs/structs/d3d12xbox_sync_params).

Para obter informações sobre barreiras, consulte **CPU/GPU Synchronization** em [Porting from Direct3D 11 to Direct3D 12](https://learn.microsoft.com/en-us/windows/win32/direct3d12/porting-from-direct3d-11-to-direct3d-12#cpugpu-synchronization).

## Requisitos

**Cabeçalho:** d3d12\_xs.h\
**Biblioteca:** d3d12\_xs.lib\
**Plataformas com suporte**: consoles XBOX Series

## Confira também

[D3D12\_SYNC\_CONTROL\_FLAGS](/pt-BR/reference/graphics/d3d12_xs/enums/d3d12xbox_sync_control_flags)\
[Signal2X](/pt-BR/reference/graphics/d3d12_xs/interfaces/ID3D12CommandQueue/methods/id3d12commandqueue_signal2x)\
[SyncBottomOfPipeX](/pt-BR/reference/graphics/d3d12_xs/interfaces/ID3D12GraphicsCommandList6/methods/id3d12graphicscommandlist6_syncbottomofpipex)\
[SyncTopOfPipeX](/pt-BR/reference/graphics/d3d12_xs/interfaces/ID3D12GraphicsCommandList6/methods/id3d12graphicscommandlist6_synctopofpipex)\
[ID3D12CommandQueue](/pt-BR/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)