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

# AcpHalCreate

> AcpHalCreate

# AcpHalCreate

Cria uma instância da interface do Audio Control Processor (ACP).

## Sintaxe

```cpp theme={null}
HRESULT AcpHalCreate(  
         IAcpHal** acp  
)  
```

### Parâmetros

*acp*   \_Outptr\_\
Tipo: IAcpHal\*\*

Uma instância da interface do ACP.

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

| Código de retorno | Descrição |
| - | - |
| E\_OUTOFMEMORY | Falha na alocação de memória. |

## Comentários

Essa chamada cria um cliente do ACP, que pode processar um flowgraph por vez. Se vários flowgraphs precisarem ser processados simultaneamente, crie vários clientes.

Todos os contextos a serem usados com um cliente do ACP devem ser alocados com [AcpHalAllocateShapeContexts](/pt-BR/reference/audio/acphal/functions/acphalallocateshapecontexts) antes de chamar [AcpHalCreate](/pt-BR/reference/audio/acphal/functions/acphalcreate).

## Requisitos

**Cabeçalho:** acphal.h

**Biblioteca:** acphal.lib

**Plataformas com suporte:** consoles da família XBOX One e consoles XBOX Series

## Confira também

[AcpHal](/pt-BR/reference/audio/acphal/acphal_members)


## Related topics

- [IAcpHal](/pt-BR/reference/audio/acphal/interfaces/IAcpHal/iacphal.md)
- [AcpHal](/pt-BR/reference/audio/acphal/acphal_members.md)
- [AcpHalAllocateShapeContexts](/pt-BR/reference/audio/acphal/functions/acphalallocateshapecontexts.md)
- [IAcpHal::Connect](/pt-BR/reference/audio/acphal/interfaces/IAcpHal/methods/iacphal_connect.md)
- [ACP_MESSAGE_ERROR](/pt-BR/reference/audio/acphal/structs/acp_message_error.md)