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

# Wait

> Enfileira uma espera do lado da GPU e retorna imediatamente. Uma espera do lado da GPU é aquela em que a GPU aguarda até que o fence especificado alcance ou exceda o valor especificado.

Enfileira uma espera do lado da GPU e retorna imediatamente. Uma espera do lado da GPU é aquela em que a GPU aguarda até que o fence especificado alcance ou exceda o valor especificado.

## Sintaxe

```cpp theme={null}
HRESULT Wait(
    ID3D12Fence  pFence,
    UINT64 Value
)
```

### Parâmetros

*pFence*\
Tipo: ID3D12Fence \*

Um ponteiro para o objeto [ID3D12Fence](/pt-BR/reference/graphics/d3d12/interfaces/id3d12fence/id3d12fence_public).

*Value*\
Tipo: UINT64

O valor que a fila de comandos está aguardando que o fence alcance ou exceda.  Assim, quando [ID3D12Fence::GetCompletedValue](/pt-BR/reference/graphics/d3d12/interfaces/id3d12fence/methods/id3d12fence_getcompletedvalue_public) for maior ou igual a <i>Value</i>, a espera será encerrada.

### Valor retornado

Tipo: HRESULT

Este método retorna um dos [Códigos de retorno do Direct3D 12](https://learn.microsoft.com/en-us/windows/win32/direct3d12/d3d12-graphics-reference-returnvalues).

## Comentários

Como uma espera está sendo enfileirada, a API retorna imediatamente. É a fila de comandos que aguarda (período durante o qual nenhum trabalho é executado) até que o fence especificado alcance o valor solicitado.

Se você quiser realizar uma espera do lado da CPU (em que o thread de chamada fica bloqueado até que um fence alcance um valor específico), use a API [**ID3D12Fence::SetEventOnCompletion**](/pt-BR/reference/graphics/d3d12/interfaces/id3d12fence/methods/id3d12fence_seteventoncompletion_public) em conjunto com [**WaitForSingleObject**](https://learn.microsoft.com/en-us/windows/win32/api/synchapi/nf-synchapi-waitforsingleobject) (ou uma API semelhante).

## Requisitos

**Cabeçalho:** d3d12\_xs.h ou d3d12\_x.h\
**Biblioteca:** d3d12\_xs.lib ou d3d12\_x.lib\
**Plataformas compatíveis**: consoles XBOX Series e família XBOX One

## Confira também

[ID3D12CommandQueue](/pt-BR/reference/graphics/d3d12_xs/interfaces/ID3D12CommandQueue/id3d12commandqueue_xs)

[Sincronização de vários mecanismos](https://learn.microsoft.com/en-us/windows/win32/direct3d12/user-mode-heap-synchronization)


## Related topics

- [XtfWaitForConsoleState](/pt-BR/reference/tools/xtf/xtfapi/functions/xtfwaitforconsolestate.md)
- [D3D12_MULTIPLE_FENCE_WAIT_FLAGS](/pt-BR/reference/graphics/d3d12/enums/d3d12_multiple_fence_wait_flags_public.md)
- [XblMultiplayerManagerEstimatedMatchWaitTime](/pt-BR/reference/live/xsapi-c/multiplayer_manager_c/functions/xblmultiplayermanagerestimatedmatchwaittime.md)
- [IGameInputDispatcher::OpenWaitHandle](/pt-BR/reference/input/gameinput/interfaces/IGameInputDispatcher/methods/igameinputdispatcher_openwaithandle.md)
- [XTaskQueueRegisterWaiter](/pt-BR/reference/system/xtaskqueue/functions/xtaskqueueregisterwaiter.md)