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

# Wait32BitValueX (família XBOX One)

> Aguarda que o valor de 32 bits em um local de origem especificado na memória satisfaça uma condição de comparação.

Aguarda que o valor de 32 bits em um local de origem especificado na memória satisfaça uma condição de comparação.

## Sintaxe

```cpp theme={null}
void Wait32BitValueX(  
         D3D12_GPU_VIRTUAL_ADDRESS Address,  
         D3D12_COMPARISON_FUNC ComparisonFunction,  
         UINT ReferenceValue,  
         UINT MaskValue,  
         D3D12XBOX_WAIT_FLAGS Flags  
)  
```

### Parâmetros

*Address*   \_In\_\
Tipo: [D3D12\_GPU\_VIRTUAL\_ADDRESS](https://learn.microsoft.com/en-us/windows/win32/direct3d12/d3d12_gpu_virtual_address)

O endereço base da memória gráfica que contém o valor de avaliação para a espera. O endereço deve estar alinhado em 4 bytes.

*ComparisonFunction*   \_In\_\
Tipo: [D3D12\_COMPARISON\_FUNC](https://learn.microsoft.com/en-us/windows/win32/api/d3d12/ne-d3d12-d3d12_comparison_func)

Uma constante de enumeração **D3D12\_COMPARISON\_FUNC** que especifica a função a ser usada como base para a condição de espera.

O valor no local de memória *Address* é testado em relação a *ReferenceValue* usando essa função. As esperas executadas usando o mecanismo PFP podem empregar somente uma *ComparisonFunction* igual a **D3D12\_COMPARISON\_FUNC\_GREATER\_EQUAL**.

*ReferenceValue*   \_In\_\
Tipo: UINT

O valor a ser usado como base de comparação para a espera.

*MaskValue*   \_In\_\
Tipo: UINT

A máscara a ser aplicada ao valor da memória antes da comparação. A máscara é aplicada como uma operação AND bit a bit.

*Flags*   \_In\_\
Tipo: [D3D12XBOX\_WAIT\_FLAGS](/pt-BR/reference/graphics/d3d12_x/enums/d3d12xbox_wait_flags)

Um conjunto opcional de constantes de enumeração **D3D12XBOX\_WAIT\_FLAGS** combinadas com OR bit a bit que especificam qual mecanismo usar para executar a espera:

* **D3D12XBOX\_WAIT\_FLAG\_NONE** executa a espera usando o Micro-Engine (ME).
* **D3D12XBOX\_WAIT\_FLAG\_SELECT\_ENGINE\_PFP** executa a espera usando o mecanismo PFP (pre-fetch parser).

### Valor retornado

Tipo: void

Nenhum.

## Comentários

Uma espera é satisfeita quando ((Valor-em-*Address* & *MaskValue*) \<*ComparisonFunction*> *ReferenceValue*) é avaliado como **true**.

<Note>
  Não satisfazer a condição de espera faz com que a GPU trave. Emita esperas com cuidado.
</Note>

## Requisitos

**Cabeçalho:** d3d12\_x.h

**Biblioteca:** d3d12\_x.lib

**Plataformas compatíveis:** família XBOX One

## Confira também

[ID3D12GraphicsCommandList](/pt-BR/reference/graphics/d3d12_x/interfaces/id3d12graphicscommandlist/id3d12graphicscommandlist)\
[Wait64BitValueX](/pt-BR/reference/graphics/d3d12_x/interfaces/id3d12xboxdmacommandlist/methods/id3d12xboxdmacommandlist_wait64bitvaluex)\
[Write32BitValueBottomOfPipeX](/pt-BR/reference/graphics/d3d12_x/interfaces/id3d12graphicscommandlist/methods/id3d12graphicscommandlist_write32bitvaluebottomofpipex)


## Related topics

- [Diretório de tópicos NDA: links ativos do Microsoft Learn](/pt-BR/nda/nda-topic-directory.md)
- [GetXmaFrameBitPosition](/pt-BR/reference/audio/xma2defs/functions/getxmaframebitposition.md)
- [GetXmaFrameLengthInBits](/pt-BR/reference/audio/xma2defs/functions/getxmaframelengthinbits.md)
- [GetLastXmaFrameBitPosition](/pt-BR/reference/audio/xma2defs/functions/getlastxmaframebitposition.md)
- [SetComputeRoot32BitConstant](/pt-BR/reference/graphics/d3d12/interfaces/id3d12graphicscommandlist/methods/id3d12graphicscommandlist_setcomputeroot32bitconstant_public.md)