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

# AcpHalAllocateShapeContexts

> AcpHalAllocateShapeContexts

# AcpHalAllocateShapeContexts

Aloca matrizes de contexto para o Scalable Hardware Audio Processing Engine (SHAPE) e o XBOX Media Audio (XMA).

## Sintaxe

```cpp theme={null}
HRESULT AcpHalAllocateShapeContexts(  
         SHAPE_CONTEXTS* contextArrays  
)  
```

### Parâmetros

*contextArrays*   \_Inout\_\
Tipo: [SHAPE\_CONTEXTS\*](https://docs.xbox.com/pt-BR/reference/audio/acphal/structs/shape_contexts.md)

Na entrada, o contexto deve conter o tamanho solicitado das matrizes de contexto. Se a função for bem-sucedida, o contexto será preenchido com as matrizes alocadas. Consulte as estruturas [SHAPE\_DMA\_CONTEXT](https://docs.xbox.com/pt-BR/reference/audio/shapedmacontext/structs/shape_dma_context.md), [SHAPE\_EQCOMP\_CONTEXT](https://docs.xbox.com/pt-BR/reference/audio/shapeeqcompcontext/structs/shape_eqcomp_context.md), [SHAPE\_FILTVOL\_CONTEXT](https://docs.xbox.com/pt-BR/reference/audio/shapefiltvolcontext/structs/shape_filtvol_context.md), [SHAPE\_PCM\_CONTEXT](https://docs.xbox.com/pt-BR/reference/audio/shapepcmcontext/structs/shape_pcm_context.md), [SHAPE\_SRC\_CONTEXT](https://docs.xbox.com/pt-BR/reference/audio/shapesrccontext/structs/shape_src_context.md) e [SHAPE\_XMA\_CONTEXT](https://docs.xbox.com/pt-BR/reference/audio/shapexmacontext/structs/shape_xma_context.md).

### 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\_INVALIDARG | Um ou mais argumentos são inválidos. |
| E\_OUTOFMEMORY | Falha na alocação de memória. |
| ACP\_E\_ALREADY\_ALLOCATED | As matrizes de contexto já estão alocadas. |

## Comentários

Chame este método para alocar contextos para um cliente do Audio Control Processor (ACP) antes de chamar [AcpHalCreate](https://docs.xbox.com/pt-BR/reference/audio/acphal/functions/acphalcreate.md).

A menos que haja uma chamada subsequente para [AcpHalReleaseShapeContexts](https://docs.xbox.com/pt-BR/reference/audio/acphal/functions/acphalreleaseshapecontexts.md), este método deve ser chamado apenas uma vez.

O número de contextos do Sample Rate Convertor (SRC) deve ser igual à soma do número de contextos de modulação por código de pulso (PCM) e do número de contextos XMA.

## Requisitos

**Cabeçalho:** acphal.h

**Biblioteca:** acphal.lib

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

## Confira também

[AcpHalReleaseShapeContexts](https://docs.xbox.com/pt-BR/reference/audio/acphal/functions/acphalreleaseshapecontexts.md)\
[AcpHalCreate](https://docs.xbox.com/pt-BR/reference/audio/acphal/functions/acphalcreate.md)\
[AcpHal](https://docs.xbox.com/pt-BR/reference/audio/acphal/acphal_members.md)


## Related topics

- [AcpHalReleaseShapeContexts](https://docs.xbox.com/pt-BR/reference/audio/acphal/functions/acphalreleaseshapecontexts.md)
- [SHAPE_CONTEXTS](https://docs.xbox.com/pt-BR/reference/audio/acphal/structs/shape_contexts.md)
- [AcpHal](https://docs.xbox.com/pt-BR/reference/audio/acphal/acphal_members.md)
- [AcpHalCreate](https://docs.xbox.com/pt-BR/reference/audio/acphal/functions/acphalcreate.md)
- [IAcpHal::Connect](https://docs.xbox.com/pt-BR/reference/audio/acphal/interfaces/IAcpHal/methods/iacphal_connect.md)