Pular para o conteúdo principal

IAcpHal::Connect

Conecta-se ao ACP.

Sintaxe

Parâmetros

numCommands   
Tipo: UINT32
Especifica o número de comandos a serem alocados na fila de comandos do ACP. Esse valor deve ser maior que zero e grande o suficiente para lidar com tantos comandos quantos forem emitidos para cada quadro de áudio de 2,67 ms. numMessages   
Tipo: UINT32
Especifica o número de mensagens a serem alocadas na fila de mensagens do ACP. Esse valor pode ser zero se o título não processar as mensagens recebidas. Se houver registro para mensagens de comando concluído (consulte ACP_MESSAGE_TYPE), haverá pelo menos tantas mensagens quanto comandos. Normalmente, essa fila de mensagens é processada com menos frequência do que uma vez por quadro de áudio, portanto, planeje o equivalente a vários quadros de mensagens.

Valor retornado

Tipo: HRESULT Se o método for bem-sucedido, ele retornará S_OK. Se o método falhar, ele retornará um dos seguintes códigos (lista parcial):

Comentários

Chame este método antes de chamar qualquer outro método desta interface. No entanto, depois de chamar Disconnect, você pode chamar este método novamente. Consulte também SubmitCommand. Se o método falhar com um erro diferente de E_INVALIDARG ou ACP_E_ALREADY_CONNECTED, é recomendável que todos os objetos de cliente do ACP existentes sejam destruídos e que os contextos SHAPE alocados sejam liberados usando AcpHalReleaseShapeContexts. Novos contextos SHAPE e objetos de cliente do ACP devem ser alocados/criados novamente conforme necessário usando AcpHalAllocateShapeContexts e AcpHalCreate, respectivamente.

Requisitos

Cabeçalho: acphal.h Plataformas com suporte: consoles da família XBOX One e consoles XBOX Series

Confira também

Disconnect
AcpHal
Última modificação em 6 de outubro de 2026