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

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

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

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

À moins d'un appel subséquent à [AcpHalReleaseShapeContexts](/fr-CA/reference/audio/acphal/functions/acphalreleaseshapecontexts), 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](/fr-CA/reference/audio/acphal/functions/acphalreleaseshapecontexts)\
[AcpHalCreate](/fr-CA/reference/audio/acphal/functions/acphalcreate)\
[AcpHal](/fr-CA/reference/audio/acphal/acphal_members)


## Related topics

- [AcpHalAllocateShapeContexts](/reference/audio/acphal/functions/acphalallocateshapecontexts.md)
- [AcpHal](/reference/audio/acphal/acphal_members.md)
- [SHAPE_CONTEXTS](/reference/audio/acphal/structs/shape_contexts.md)
- [AcpHalReleaseShapeContexts](/es/reference/audio/acphal/functions/acphalreleaseshapecontexts.md)