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

# 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\*](/pt-BR/reference/audio/acphal/structs/shape_contexts)

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](/pt-BR/reference/audio/shapedmacontext/structs/shape_dma_context), [SHAPE\_EQCOMP\_CONTEXT](/pt-BR/reference/audio/shapeeqcompcontext/structs/shape_eqcomp_context), [SHAPE\_FILTVOL\_CONTEXT](/pt-BR/reference/audio/shapefiltvolcontext/structs/shape_filtvol_context), [SHAPE\_PCM\_CONTEXT](/pt-BR/reference/audio/shapepcmcontext/structs/shape_pcm_context), [SHAPE\_SRC\_CONTEXT](/pt-BR/reference/audio/shapesrccontext/structs/shape_src_context) e [SHAPE\_XMA\_CONTEXT](/pt-BR/reference/audio/shapexmacontext/structs/shape_xma_context).

### 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](/pt-BR/reference/audio/acphal/functions/acphalcreate).

A menos que haja uma chamada subsequente para [AcpHalReleaseShapeContexts](/pt-BR/reference/audio/acphal/functions/acphalreleaseshapecontexts), 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](/pt-BR/reference/audio/acphal/functions/acphalreleaseshapecontexts)\
[AcpHalCreate](/pt-BR/reference/audio/acphal/functions/acphalcreate)\
[AcpHal](/pt-BR/reference/audio/acphal/acphal_members)


## Related topics

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