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

Asigna matrices de contextos para el motor de procesamiento de audio por hardware escalable (SHAPE) y XBOX Media Audio (XMA).

## Sintaxis

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

### Parámetros

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

En la entrada, el contexto debe contener el tamaño solicitado de las matrices de contextos. Si la función se ejecuta correctamente, el contexto se rellena con las matrices asignadas. Consulte las estructuras [SHAPE\_DMA\_CONTEXT](https://docs.xbox.com/es/reference/audio/shapedmacontext/structs/shape_dma_context.md), [SHAPE\_EQCOMP\_CONTEXT](https://docs.xbox.com/es/reference/audio/shapeeqcompcontext/structs/shape_eqcomp_context.md), [SHAPE\_FILTVOL\_CONTEXT](https://docs.xbox.com/es/reference/audio/shapefiltvolcontext/structs/shape_filtvol_context.md), [SHAPE\_PCM\_CONTEXT](https://docs.xbox.com/es/reference/audio/shapepcmcontext/structs/shape_pcm_context.md), [SHAPE\_SRC\_CONTEXT](https://docs.xbox.com/es/reference/audio/shapesrccontext/structs/shape_src_context.md) y [SHAPE\_XMA\_CONTEXT](https://docs.xbox.com/es/reference/audio/shapexmacontext/structs/shape_xma_context.md).

### Valor devuelto

Tipo: HRESULT

Si el método se ejecuta correctamente, devuelve `S_OK`. Si el método falla, devuelve uno de los códigos siguientes (lista parcial):

| Código devuelto | Descripción |
| - | - |
| E\_INVALIDARG | Uno o varios de los argumentos no son válidos. |
| E\_OUTOFMEMORY | Error en la asignación de memoria. |
| ACP\_E\_ALREADY\_ALLOCATED | Las matrices de contextos ya están asignadas. |

## Comentarios

Llame a este método para asignar contextos para un cliente del procesador de control de audio (ACP) antes de llamar a [AcpHalCreate](https://docs.xbox.com/es/reference/audio/acphal/functions/acphalcreate.md).

A menos que haya una llamada posterior a [AcpHalReleaseShapeContexts](https://docs.xbox.com/es/reference/audio/acphal/functions/acphalreleaseshapecontexts.md), este método solo debe llamarse una vez.

El número de contextos del convertidor de frecuencia de muestreo (SRC) debe ser igual a la suma del número de contextos de modulación por impulsos codificados (PCM) y el número de contextos XMA.

## Requisitos

**Encabezado:** acphal.h

**Biblioteca:** acphal.lib

**Plataformas compatibles:** consolas de la familia XBOX One y consolas XBOX Series

## Consulte también

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


## Related topics

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