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

Alloue des tableaux de contextes pour le Scalable Hardware Audio Processing Engine (SHAPE) et XBOX Media Audio (XMA).

## Syntaxe

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

### Paramètres

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

En entrée, le contexte doit contenir la taille demandée des tableaux de contextes. Si la fonction réussit, le contexte est rempli avec les tableaux alloués. Consultez les structures [SHAPE\_DMA\_CONTEXT](https://docs.xbox.com/fr-CA/reference/audio/shapedmacontext/structs/shape_dma_context.md), [SHAPE\_EQCOMP\_CONTEXT](https://docs.xbox.com/fr-CA/reference/audio/shapeeqcompcontext/structs/shape_eqcomp_context.md), [SHAPE\_FILTVOL\_CONTEXT](https://docs.xbox.com/fr-CA/reference/audio/shapefiltvolcontext/structs/shape_filtvol_context.md), [SHAPE\_PCM\_CONTEXT](https://docs.xbox.com/fr-CA/reference/audio/shapepcmcontext/structs/shape_pcm_context.md), [SHAPE\_SRC\_CONTEXT](https://docs.xbox.com/fr-CA/reference/audio/shapesrccontext/structs/shape_src_context.md) et [SHAPE\_XMA\_CONTEXT](https://docs.xbox.com/fr-CA/reference/audio/shapexmacontext/structs/shape_xma_context.md).

### Valeur de retour

Type : HRESULT

Si la méthode réussit, elle renvoie `S_OK`. Si la méthode échoue, elle renvoie l'un des codes suivants (liste partielle) :

| Code de retour | Description |
| - | - |
| E\_INVALIDARG | Un ou plusieurs arguments ne sont pas valides. |
| E\_OUTOFMEMORY | L'allocation de mémoire a échoué. |
| ACP\_E\_ALREADY\_ALLOCATED | Les tableaux de contextes sont déjà alloués. |

## Remarques

Appelez cette méthode pour allouer des contextes pour un client de l'Audio Control Processor (ACP) avant d'appeler [AcpHalCreate](https://docs.xbox.com/fr-CA/reference/audio/acphal/functions/acphalcreate.md).

À moins d'un appel subséquent à [AcpHalReleaseShapeContexts](https://docs.xbox.com/fr-CA/reference/audio/acphal/functions/acphalreleaseshapecontexts.md), cette méthode ne doit être appelée qu'une seule fois.

Le nombre de contextes de convertisseur de fréquence d'échantillonnage (SRC) doit être égal à la somme du nombre de contextes de modulation par impulsions et codage (PCM) et du nombre de contextes XMA.

## Configuration requise

**En-tête :** acphal.h

**Bibliothèque :** acphal.lib

**Plateformes prises en charge :** consoles de la famille XBOX One et consoles XBOX Series

## Voir aussi

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


## Related topics

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