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

# SHAPE_CONTEXTS

> SHAPE_CONTEXTS

# SHAPE\_CONTEXTS

Dados de contexto do Scalable Hardware Audio Processing Engine (SHAPE).

## Sintaxe

```cpp theme={null}
typedef struct SHAPE_CONTEXTS {  
    UINT32 numSrcContexts;  
    UINT32 numEqCompContexts;  
    UINT32 numFiltVolContexts;  
    UINT32 numDmaContexts;  
    UINT32 numXmaContexts;  
    UINT32 numPcmContexts;  
    SHAPE_SRC_CONTEXT* srcContextArray;  
    SHAPE_EQCOMP_CONTEXT* eqCompContextArray;  
    SHAPE_FILTVOL_CONTEXT* filtVolContextArray;  
    SHAPE_DMA_CONTEXT* dmaContextArray;  
    SHAPE_XMA_CONTEXT* xmaContextArray;  
    SHAPE_PCM_CONTEXT* pcmContextArray;  
    APU_ADDRESS apuSrcContextArray;  
    APU_ADDRESS apuEqCompContextArray;  
    APU_ADDRESS apuFiltVolContextArray;  
    APU_ADDRESS apuDmaContextArray;  
    APU_ADDRESS apuXmaContextArray;  
    APU_ADDRESS apuPcmContextArray;  
} SHAPE_CONTEXTS  
```

### Membros

*numSrcContexts*\
Tipo: UINT32

Número de contextos de Conversor de Taxa de Amostragem (SCR) a serem alocados.

*numEqCompContexts*\
Tipo: UINT32

Número de contextos EQ/Comp a serem alocados.

*numFiltVolContexts*\
Tipo: UINT32

Número de contextos de Filtro/Volume a serem alocados.

*numDmaContexts*\
Tipo: UINT32

Número de contextos de Acesso Direto à Memória (DMA) a serem alocados.

*numXmaContexts*\
Tipo: UINT32

Número de contextos XBOX Media Audio (XMA) a serem alocados.

*numPcmContexts*\
Tipo: UINT32

Número de contextos de modulação por código de pulso (PCM) a serem alocados.

*srcContextArray*\
Tipo: SHAPE\_SRC\_CONTEXT\*

Matriz de contextos SRC.

*eqCompContextArray*\
Tipo: SHAPE\_EQCOMP\_CONTEXT\*

Matriz de contextos EQ/Comp.

*filtVolContextArray*\
Tipo: SHAPE\_FILTVOL\_CONTEXT\*

Matriz de contextos de Filtro/Volume.

*dmaContextArray*\
Tipo: SHAPE\_DMA\_CONTEXT\*

Matriz de contextos DMA.

*xmaContextArray*\
Tipo: SHAPE\_XMA\_CONTEXT\*

Matriz de contextos XMA.

*pcmContextArray*\
Tipo: SHAPE\_PCM\_CONTEXT\*

Matriz de contextos PCM.

*apuSrcContextArray*\
Tipo: APU\_ADDRESS

Endereço físico da matriz de contextos SRC.

*apuEqCompContextArray*\
Tipo: APU\_ADDRESS

Endereço físico da matriz de contextos EQ/Comp.

*apuFiltVolContextArray*\
Tipo: APU\_ADDRESS

Endereço físico da matriz de contextos de Filtro/Volume.

*apuDmaContextArray*\
Tipo: APU\_ADDRESS

Endereço físico da matriz de contextos DMA.

*apuXmaContextArray*\
Tipo: APU\_ADDRESS

Endereço físico da matriz de contextos XMA.

*apuPcmContextArray*\
Tipo: APU\_ADDRESS

Endereço físico da matriz de contextos PCM.

## Comentários

Essa estrutura é usada pela função [AcpHalAllocateShapeContexts](/pt-BR/reference/audio/acphal/functions/acphalallocateshapecontexts). A estrutura especifica os tamanhos das novas matrizes de contextos e contém as matrizes alocadas retornadas pela função.

Consulte as seguintes 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)
* [SHAPE\_XMA\_CONTEXT](/pt-BR/reference/audio/shapexmacontext/structs/shape_xma_context)

## Requisitos

**Cabeçalho:** acphal.h

**Plataformas compatíveis:** consoles da família XBOX One e consoles XBOX Series

## Confira também

[AcpHalAllocateShapeContexts](/pt-BR/reference/audio/acphal/functions/acphalallocateshapecontexts)\
[AcpHal](/pt-BR/reference/audio/acphal/acphal_members)


## Related topics

- [SHARED_SHAPE_CONTEXTS](/pt-BR/reference/audio/acphal/structs/shared_shape_contexts.md)
- [AcpHalAllocateShapeContexts](/pt-BR/reference/audio/acphal/functions/acphalallocateshapecontexts.md)
- [AcpHal](/pt-BR/reference/audio/acphal/acphal_members.md)
- [ShapeContexts](/pt-BR/reference/audio/shapecontexts/shapecontexts_members.md)
- [ShapePeakMagnitudeToDecibel](/pt-BR/reference/audio/shapecontexts/functions/shapepeakmagnitudetodecibel.md)