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

# IAcpHal::Connect

> IAcpHal::Connect

# IAcpHal::Connect

Se conecta al ACP.

## Sintaxis

```cpp theme={null}
HRESULT Connect(  
         UINT32 numCommands,  
         UINT32 numMessages  
)  
```

### Parámetros

*numCommands*   \
Tipo: UINT32

Especifica el número de comandos que se van a asignar en la cola de comandos del ACP. Este valor debe ser mayor que cero y lo suficientemente grande como para controlar tantos comandos como se hayan emitido para cada fotograma de audio de 2,67 ms.

*numMessages*   \
Tipo: UINT32

Especifica el número de mensajes que se van a asignar en la cola de mensajes del ACP. Este valor puede ser cero si el título no procesa los mensajes recibidos. Si se ha realizado el registro para los mensajes de *comando completado* (consulte [ACP\_MESSAGE\_TYPE](/reference/audio/acphal/enums/acp_message_type)), habrá al menos tantos mensajes como comandos. Normalmente, esta cola de mensajes se procesa con una frecuencia inferior a una vez por fotograma de audio, por lo que debe prever mensajes equivalentes a varios fotogramas.

### Valor devuelto

Tipo: HRESULT

Si el método se ejecuta correctamente, devuelve `S_OK`. Si el método falla, devuelve uno de los códigos siguientes (lista parcial):

| Código devuelto            | Descripción                                                                                           |
| -------------------------- | ----------------------------------------------------------------------------------------------------- |
| E\_INVALIDARG              | Uno o varios de los argumentos no son válidos, o el parámetro *numCommands* está establecido en cero. |
| E\_OUTOFMEMORY             | Error en la asignación de memoria.                                                                    |
| ACP\_E\_ALREADY\_CONNECTED | Ya está conectado al ACP.                                                                             |
| E\_UNEXPECTED              | Se produjo un error inesperado.                                                                       |
| ACP\_E\_QUEUE\_FULL        | La cola del ACP está llena.                                                                           |
| E\_TIMEOUT                 | Se produjo un error de tiempo de espera.                                                              |

## Comentarios

Llame a este método antes de llamar a cualquier otro método de esta interfaz. Sin embargo, después de llamar a [Disconnect](/reference/audio/acphal/interfaces/IAcpHal/methods/iacphal_disconnect), puede volver a llamar a este método. Consulte también [SubmitCommand](/reference/audio/acphal/interfaces/IAcpHal/methods/iacphal_submitcommand).

Si el método falla por un error distinto de `E_INVALIDARG` o `ACP_E_ALREADY_CONNECTED`, se recomienda destruir **todos** los objetos de cliente del ACP existentes y liberar los contextos de SHAPE asignados mediante [AcpHalReleaseShapeContexts](/reference/audio/acphal/functions/acphalreleaseshapecontexts). Los nuevos contextos de SHAPE y los objetos de cliente del ACP deben asignarse o crearse de nuevo según sea necesario mediante [AcpHalAllocateShapeContexts](/reference/audio/acphal/functions/acphalallocateshapecontexts) y [AcpHalCreate](/reference/audio/acphal/functions/acphalcreate), respectivamente.

## Requisitos

**Encabezado:** acphal.h

**Plataformas compatibles:** consolas de la familia XBOX One y consolas XBOX Series

## Consulte también

[Disconnect](/reference/audio/acphal/interfaces/IAcpHal/methods/iacphal_disconnect)\
[AcpHal](/reference/audio/acphal/acphal_members)


## Related topics

- [IAcpHal](/es/reference/audio/acphal/interfaces/IAcpHal/iacphal.md)
- [Procedimientos recomendados para la construcción de flowgraphs de audio de SHAPE](/es/build/console-features/audio/overviews/best-practices-audio-flowgraph-construction.md)
- [IAcpHal::Disconnect](/es/reference/audio/acphal/interfaces/IAcpHal/methods/iacphal_disconnect.md)
- [IAcpHal::PopMessage](/es/reference/audio/acphal/interfaces/IAcpHal/methods/iacphal_popmessage.md)
- [IAcpHal::SubmitCommand](/es/reference/audio/acphal/interfaces/IAcpHal/methods/iacphal_submitcommand.md)