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

# XApuConnect

> XApuConnect

# XApuConnect

Establece una conexión y asigna los recursos necesarios para una unidad de procesamiento de audio (XAPU).

## Sintaxis

```cpp theme={null}
HRESULT XApuConnect(  
         XApuConnectInputParameters* params,  
         XApuConnectOutputParameters* data,  
         XApuHandle* handle  
)  
```

### Parámetros

*params*   \_In\_\
Tipo: [XApuConnectInputParameters\*](/reference/audio/xapu/structs/xapuconnectinputparameters)

Parámetros que se pasan a XApuConnect para los recursos asignados.

*data*   \_Out\_\
Tipo: [XApuConnectOutputParameters\*](/reference/audio/xapu/structs/xapuconnectoutputparameters)

Parámetros devueltos por XApuConnect.

*handle*   \_Outptr\_\
Tipo: XApuHandle\*

Puntero a un identificador de XAPU devuelto. Este identificador se usa para indicar qué instancia de XAPU se debe manipular al llamar a otras API de XAPU.

### Valor devuelto

Tipo: HRESULT

Devuelve S\_OK si se ejecuta correctamente; de lo contrario, devuelve un código de error.

## Comentarios

El autor de la llamada debe especificar un [XApuProcessType](/reference/audio/xapu/enums/xapuprocesstype) que ejecutará el cliente de XAPU. Una instancia de XAPU puede trabajar con un tipo de proceso durante su vigencia. Para realizar dos o más procesos diferentes, se deben crear dos o más instancias de XAPU.

Dentro de [XApuConnectInputParameters](/reference/audio/xapu/structs/xapuconnectinputparameters), el autor de la llamada debe especificar lo siguiente:

* Número máximo de secuencias que se espera que XAPU procese simultáneamente.
* Número máximo de comandos en cola para cada secuencia.
* Asignación de memoria total necesaria para todos los comandos y secuencias. Esto incluye las asignaciones totales para los datos de entrada, salida y procesamiento en el número máximo de secuencias multiplicado por los comandos en cola por secuencia.

Si la llamada se ejecuta correctamente, el parámetro [XApuConnectOutputParameters::baseData](/reference/audio/xapu/structs/xapuconnectoutputparameters) apuntará a un fragmento de memoria que el autor de la llamada debe usar para pasar los datos de entrada y recuperar los datos de salida de las secuencias. Corresponde al autor de la llamada particionar y reciclar este fragmento de memoria. La asignación se liberará al llamar a [XApuDisconnect](/reference/audio/xapu/functions/xapudisconnect).

[XApuConnectOutputParameters::resultReadyEvent](/reference/audio/xapu/structs/xapuconnectoutputparameters) contendrá un identificador de evento Win32 cuando se establezca [XApuConnectOptions::EnableResultReadyEvent](/reference/audio/xapu/enums/xapuconnectoptions). Este identificador se cerrará al llamar a [XApuDisconnect](/reference/audio/xapu/functions/xapudisconnect).

Este identificador se cerrará al llamar a [XApuDisconnect](/reference/audio/xapu/functions/xapudisconnect).

No se recomienda llamar a [XapuConnect](/reference/audio/xapu/functions/xapuconnect) y [XApuDisconnect](/reference/audio/xapu/functions/xapudisconnect) con frecuencia para iniciar y detener secuencias, ya que esas llamadas consumen mucho tiempo y también podrían provocar pérdidas de recursos debido a la fragmentación de la memoria. En su lugar, se debe llamar a [XapuConnect](/reference/audio/xapu/functions/xapuconnect) una vez al inicializar la sesión de transmisión y, a continuación, usar [XApuCommandType::Activate](/reference/audio/xapu/enums/xapucommandtype) y [XApuCommandType::Deactivate](/reference/audio/xapu/enums/xapucommandtype) para iniciar y detener secuencias durante la transmisión. Al final de la sesión de transmisión, se debe llamar a [XApuDisconnect](/reference/audio/xapu/functions/xapudisconnect). Esto se aplica a todos los clientes de XAPU.

## Requisitos

**Encabezado:** xapu.h

**Biblioteca:** xapu.lib

**Plataformas compatibles:** XBOX Series X|S

## Documentación conceptual

* [Información general de XAPU](/build/console-features/audio/overviews/xapu-overview)

## Consulte también

[XAPU](/reference/audio/xapu/xapu_members)\
[XApuDecodeConvertCommand](/reference/audio/xapu/structs/xapudecodeconvertcommand)\
[XApuDequeueResult](/reference/audio/xapu/functions/xapudequeueresult)\
[XApuEnqueueCommand](/reference/audio/xapu/functions/xapuenqueuecommand)\
[XApuGetResultCount](/reference/audio/xapu/functions/xapugetresultcount)


## Related topics

- [XApuConnectOutputParameters](/es/reference/audio/xapu/structs/xapuconnectoutputparameters.md)
- [XApuConnectOptions](/es/reference/audio/xapu/enums/xapuconnectoptions.md)
- [XApuConnectInputParameters](/es/reference/audio/xapu/structs/xapuconnectinputparameters.md)
- [XApuDisconnect](/es/reference/audio/xapu/functions/xapudisconnect.md)
- [XApuDequeueResult](/es/reference/audio/xapu/functions/xapudequeueresult.md)