> ## Documentation Index
> Fetch the complete documentation index at: https://docs.xbox.com/llms.txt
> Use this file to discover all available pages before exploring further.

# XApuDequeueResult

> XApuDequeueResult

# XApuDequeueResult

Recupera um [XApuResult](https://docs.xbox.com/pt-BR/reference/audio/xapu/structs/xapuresult.md) 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](https://docs.xbox.com/pt-BR/reference/audio/xapu/functions/xapuconnect.md).

*commandResult*   \_Out\_\
Tipo: [XApuResult\*](https://docs.xbox.com/pt-BR/reference/audio/xapu/structs/xapuresult.md)

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](https://docs.xbox.com/pt-BR/reference/audio/xapu/structs/xapuresult.md) da fila de resultados, se disponível; caso contrário, a chamada retornará [XAPU\_E\_PENDING\_RESULTS](https://docs.xbox.com/pt-BR/reference/audio/xapu/enums/xapuerrors.md). 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](https://docs.xbox.com/pt-BR/reference/audio/xapu/functions/xapuenqueuecommand.md) retornará o código de erro [XAPU\_E\_DEVICE\_FATAL\_ERROR](https://docs.xbox.com/pt-BR/reference/audio/xapu/enums/xapuerrors.md). 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](https://docs.xbox.com/pt-BR/reference/audio/xapu/xapu_members.md)\
[XApuEnqueueCommand](https://docs.xbox.com/pt-BR/reference/audio/xapu/functions/xapuenqueuecommand.md)\
[XApuGetResultCount](https://docs.xbox.com/pt-BR/reference/audio/xapu/functions/xapugetresultcount.md)


## Related topics

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