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

可伸缩硬件音频处理引擎(Scalable Hardware Audio Processing Engine,SHAPE)的上下文数据。

## 语法

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

### 成员

*numSrcContexts*\
类型:UINT32

要分配的采样率转换器(Sample Rate Convertor,SRC)上下文的数量。

*numEqCompContexts*\
类型:UINT32

要分配的 EQ/Comp 上下文的数量。

*numFiltVolContexts*\
类型:UINT32

要分配的 Filter/Volume 上下文的数量。

*numDmaContexts*\
类型:UINT32

要分配的直接内存访问(Direct Memory Access,DMA)上下文的数量。

*numXmaContexts*\
类型:UINT32

要分配的 XBOX Media Audio(XMA)上下文的数量。

*numPcmContexts*\
类型:UINT32

要分配的脉冲编码调制(PCM)上下文的数量。

*srcContextArray*\
类型:SHAPE\_SRC\_CONTEXT\*

SRC 上下文数组。

*eqCompContextArray*\
类型:SHAPE\_EQCOMP\_CONTEXT\*

EQ/Comp 上下文数组。

*filtVolContextArray*\
类型:SHAPE\_FILTVOL\_CONTEXT\*

Filter/Volume 上下文数组。

*dmaContextArray*\
类型:SHAPE\_DMA\_CONTEXT\*

DMA 上下文数组。

*xmaContextArray*\
类型:SHAPE\_XMA\_CONTEXT\*

XMA 上下文数组。

*pcmContextArray*\
类型:SHAPE\_PCM\_CONTEXT\*

PCM 上下文数组。

*apuSrcContextArray*\
类型:APU\_ADDRESS

SRC 上下文数组的物理地址。

*apuEqCompContextArray*\
类型:APU\_ADDRESS

EQ/Comp 上下文数组的物理地址。

*apuFiltVolContextArray*\
类型:APU\_ADDRESS

Filter/Volume 上下文数组的物理地址。

*apuDmaContextArray*\
类型:APU\_ADDRESS

DMA 上下文数组的物理地址。

*apuXmaContextArray*\
类型:APU\_ADDRESS

XMA 上下文数组的物理地址。

*apuPcmContextArray*\
类型:APU\_ADDRESS

PCM 上下文数组的物理地址。

## 备注

此结构体由 [AcpHalAllocateShapeContexts](/reference/audio/acphal/functions/acphalallocateshapecontexts) 函数使用。该结构体指定新上下文数组的大小,并包含由该函数返回的已分配数组。

请参阅以下结构体:

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

## 要求

**头文件:** acphal.h

**支持的平台:** XBOX One 系列主机和 XBOX Series 主机

## 另请参阅

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


## Related topics

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