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

可調整硬體音訊處理引擎 (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

要配置的取樣率轉換器 (SCR) 內容數目。

*numEqCompContexts*\
類型：UINT32

要配置的 EQ/Comp 內容數目。

*numFiltVolContexts*\
類型：UINT32

要配置的 Filter/Volume 內容數目。

*numDmaContexts*\
類型：UINT32

要配置的直接記憶體存取 (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](/zh-TW/reference/audio/acphal/functions/acphalallocateshapecontexts) 函式使用。此結構會指定新內容陣列的大小，並包含函式所傳回的已配置陣列。

請參閱下列結構：

* [SHAPE\_DMA\_CONTEXT](/zh-TW/reference/audio/shapedmacontext/structs/shape_dma_context)
* [SHAPE\_EQCOMP\_CONTEXT](/zh-TW/reference/audio/shapeeqcompcontext/structs/shape_eqcomp_context)
* [SHAPE\_FILTVOL\_CONTEXT](/zh-TW/reference/audio/shapefiltvolcontext/structs/shape_filtvol_context)
* [SHAPE\_PCM\_CONTEXT](/zh-TW/reference/audio/shapepcmcontext/structs/shape_pcm_context)
* [SHAPE\_SRC\_CONTEXT](/zh-TW/reference/audio/shapesrccontext/structs/shape_src_context)
* [SHAPE\_XMA\_CONTEXT](/zh-TW/reference/audio/shapexmacontext/structs/shape_xma_context)

## 需求

**標頭：** acphal.h

**支援的平台：** XBOX One 系列主機和 XBOX Series 主機

## 另請參閱

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


## Related topics

- [SHAPE_CONTEXTS](/reference/audio/acphal/structs/shape_contexts.md)
- [SHARED_SHAPE_CONTEXTS](/reference/audio/acphal/structs/shared_shape_contexts.md)