Skip to main content

IAcpHal::Connect

Se conecta al ACP.

Sintaxis

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), 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):

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, puede volver a llamar a este método. Consulte también 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. Los nuevos contextos de SHAPE y los objetos de cliente del ACP deben asignarse o crearse de nuevo según sea necesario mediante AcpHalAllocateShapeContexts y AcpHalCreate, respectivamente.

Requisitos

Encabezado: acphal.h Plataformas compatibles: consolas de la familia XBOX One y consolas XBOX Series

Consulte también

Disconnect
AcpHal
Última modificación el 28 de agosto de 2026