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

# XApuDequeueResult

> XApuDequeueResult

# XApuDequeueResult

Recupera um [XApuResult](/pt-BR/reference/audio/xapu/structs/xapuresult) da fila de resultados, se disponível.

## Sintaxe

```cpp theme={null}
HRESULT XApuDequeueResult(  
         XApuHandle handle,  
         XApuResult* commandResult  
)  
```

### Parâmetros

*handle*   \_In\_\
Tipo: XApuHandle

Identificador retornado pela chamada de [XApuConnect](/pt-BR/reference/audio/xapu/functions/xapuconnect).

*commandResult*   \_Out\_\
Tipo: [XApuResult\*](/pt-BR/reference/audio/xapu/structs/xapuresult)

Resultado retornado pelo XAPU.

### Valor retornado

Tipo: HRESULT

Retornará S\_OK se tiver êxito; caso contrário, retornará um código de erro.

## Comentários

Recupera um [XApuResult](/pt-BR/reference/audio/xapu/structs/xapuresult) da fila de resultados, se disponível; caso contrário, a chamada retornará [XAPU\_E\_PENDING\_RESULTS](/pt-BR/reference/audio/xapu/enums/xapuerrors). Essa chamada retorna rapidamente, pois há muito pouco processamento interno. Essa chamada é thread-safe; no entanto, não há vantagem de desempenho em chamá-la de mais de um thread.

Se o servidor de hardware estiver em um estado inválido, [XApuEnqueueCommand](/pt-BR/reference/audio/xapu/functions/xapuenqueuecommand) retornará o código de erro [XAPU\_E\_DEVICE\_FATAL\_ERROR](/pt-BR/reference/audio/xapu/enums/xapuerrors). Nesse caso, todos os clientes XAPU devem ser desconectados e reconectados.

Se esse método falhar, um código de erro descritivo será retornado.

## Requisitos

**Cabeçalho:** xapu.h

**Biblioteca:** xapu.lib

**Plataformas compatíveis:** XBOX Series X|S

## Confira também

[XAPU](/pt-BR/reference/audio/xapu/xapu_members)\
[XApuEnqueueCommand](/pt-BR/reference/audio/xapu/functions/xapuenqueuecommand)\
[XApuGetResultCount](/pt-BR/reference/audio/xapu/functions/xapugetresultcount)


## Related topics

- [XApuConnect](/pt-BR/reference/audio/xapu/functions/xapuconnect.md)
- [XApuCommandId](/pt-BR/reference/audio/xapu/structs/xapucommandid.md)
- [XApuCommandType](/pt-BR/reference/audio/xapu/enums/xapucommandtype.md)
- [XApuGetResultCount](/pt-BR/reference/audio/xapu/functions/xapugetresultcount.md)
- [XAPU](/pt-BR/reference/audio/xapu/xapu_members.md)