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

# XApuConnectOutputParameters

> XApuConnectOutputParameters

# XApuConnectOutputParameters

Parâmetros retornados por [XApuConnect](/pt-BR/reference/audio/xapu/functions/xapuconnect).

## Sintaxe

```cpp theme={null}
typedef struct XApuConnectOutputParameters {  
    void* baseData;  
    HANDLE resultReadyEvent;  
} XApuConnectOutputParameters  
```

### Membros

*baseData*\
Tipo: void\*

Endereço virtual base da memória do sistema alocada que pode ser mapeada para o espaço do dispositivo se [XApuConnect](/pt-BR/reference/audio/xapu/functions/xapuconnect) tiver êxito; caso contrário, um nullptr. O chamador deve usar essa memória para passar dados de entrada e recuperar dados de saída. Além disso, o chamador deve usar essa memória para definir o buffer de processamento.

Esse buffer é alinhado em 16 bytes, e cabe ao chamador decidir como dividir essa memória em buffers de entrada, de saída e de processamento.

*resultReadyEvent*\
Tipo: HANDLE

Um identificador de evento Win32 válido se o sinalizador [XApuConnectOptions::EnableResultReadyEvent](/pt-BR/reference/audio/xapu/enums/xapuconnectoptions) estiver definido e [XApuConnect](/pt-BR/reference/audio/xapu/functions/xapuconnect) tiver êxito; caso contrário, um nullptr. Esse identificador de evento Win32 será sinalizado quando os resultados estiverem prontos para os comandos que têm o sinalizador [XApuCommandOptions::SignalOnCompletion](/pt-BR/reference/audio/xapu/enums/xapucommandoptions) definido. Esse sinal é executado em um temporizador que dispara a cada três milissegundos. Ele sinalizará uma vez se um ou mais XApuResult estiverem prontos. Ou seja, o evento será sinalizado uma vez quando vários resultados estiverem prontos dentro do período de três milissegundos e todos esses resultados tiverem o sinalizador XApuCommandOptions::SignalOnCompletion definido.

[XApuGetResultCount](/pt-BR/reference/audio/xapu/functions/xapugetresultcount) deve ser chamado depois que o evento for sinalizado para descobrir quantos XApuResult estão prontos. Não é recomendável definir [XApuCommandOptions::SignalOnCompletion](/pt-BR/reference/audio/xapu/enums/xapucommandoptions) quando vários fluxos estiverem ativados no cliente da XAPU, pois isso pode prejudicar o desempenho geral; em vez disso, o chamador deve definir o sinalizador SignalOnCompletion uma vez para um grupo de comandos. Por exemplo, defina SignalOnCompletion para todos os comandos apenas de um fluxo específico e não o defina para os outros fluxos ativados.

## Comentários

Usado por `XApuConnectOutputParameter` para passar os parâmetros retornados por `XApuConnect`. `XApuConnect` aloca os recursos necessários para uma Unidade de Processamento de Áudio (XAPU). Para obter mais informações sobre como se desconectar do mecanismo de processamento e liberar todos os recursos alocados durante `XApuConnect`, consulte [XApuDisconnect](/pt-BR/reference/audio/xapu/functions/xapudisconnect).  Para obter mais informações sobre as opções de comando, consulte [XApuCommandOptions](/pt-BR/reference/audio/xapu/enums/xapucommandoptions).

## Requisitos

**Cabeçalho:** xapu.h

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

## Confira também

[XApuDecodeConvertCommand](/pt-BR/reference/audio/xapu/structs/xapudecodeconvertcommand)\
[XAPU](/pt-BR/reference/audio/xapu/xapu_members)


## Related topics

- [XApuConnect](/pt-BR/reference/audio/xapu/functions/xapuconnect.md)
- [XApuCommandOptions](/pt-BR/reference/audio/xapu/enums/xapucommandoptions.md)
- [XApuDisconnect](/pt-BR/reference/audio/xapu/functions/xapudisconnect.md)
- [XApuConnectOptions](/pt-BR/reference/audio/xapu/enums/xapuconnectoptions.md)
- [Decodificação de áudio Opus de fluxo único com a API XAPU](/pt-BR/build/console-features/audio/overviews/xapu-overview-single-stream-audio-decode.md)