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

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

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

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

A menos que haya una llamada posterior a [AcpHalReleaseShapeContexts](/reference/audio/acphal/functions/acphalreleaseshapecontexts), 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](/reference/audio/acphal/functions/acphalreleaseshapecontexts)\
[AcpHalCreate](/reference/audio/acphal/functions/acphalcreate)\
[AcpHal](/reference/audio/acphal/acphal_members)


## Related topics

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