> ## Documentation Index
> Fetch the complete documentation index at: https://docs.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](https://docs.xbox.com/pt-BR/reference/audio/acphal/functions/acphalallocateshapecontexts.md) antes de chamar [AcpHalCreate](https://docs.xbox.com/pt-BR/reference/audio/acphal/functions/acphalcreate.md).

## 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](https://docs.xbox.com/pt-BR/reference/audio/acphal/acphal_members.md)


## Related topics

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