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

為可調整硬體音訊處理引擎 (SHAPE) 和 XBOX Media Audio (XMA) 配置內容陣列。

## 語法

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

### 參數

*contextArrays*   \_Inout\_\
類型：[SHAPE\_CONTEXTS\*](https://docs.xbox.com/zh-TW/reference/audio/acphal/structs/shape_contexts.md)

輸入時，內容應包含內容陣列的要求大小。如果函式成功，內容會填入已配置的陣列。請參閱 [SHAPE\_DMA\_CONTEXT](https://docs.xbox.com/zh-TW/reference/audio/shapedmacontext/structs/shape_dma_context.md)、[SHAPE\_EQCOMP\_CONTEXT](https://docs.xbox.com/zh-TW/reference/audio/shapeeqcompcontext/structs/shape_eqcomp_context.md)、[SHAPE\_FILTVOL\_CONTEXT](https://docs.xbox.com/zh-TW/reference/audio/shapefiltvolcontext/structs/shape_filtvol_context.md)、[SHAPE\_PCM\_CONTEXT](https://docs.xbox.com/zh-TW/reference/audio/shapepcmcontext/structs/shape_pcm_context.md)、[SHAPE\_SRC\_CONTEXT](https://docs.xbox.com/zh-TW/reference/audio/shapesrccontext/structs/shape_src_context.md) 和 [SHAPE\_XMA\_CONTEXT](https://docs.xbox.com/zh-TW/reference/audio/shapexmacontext/structs/shape_xma_context.md) 結構。

### 傳回值

類型：HRESULT

如果方法成功，會傳回 `S_OK`。如果方法失敗，會傳回下列其中一個代碼 (部分清單)：

| 傳回碼 | 描述 |
| - | - |
| E\_INVALIDARG | 一或多個引數無效。 |
| E\_OUTOFMEMORY | 記憶體配置失敗。 |
| ACP\_E\_ALREADY\_ALLOCATED | 內容陣列已配置。 |

## 備註

請在呼叫 [AcpHalCreate](https://docs.xbox.com/zh-TW/reference/audio/acphal/functions/acphalcreate.md) 之前呼叫此方法，為音訊控制處理器 (ACP) 用戶端配置內容。

除非之後有呼叫 [AcpHalReleaseShapeContexts](https://docs.xbox.com/zh-TW/reference/audio/acphal/functions/acphalreleaseshapecontexts.md)，否則此方法應該只呼叫一次。

取樣率轉換器 (SRC) 內容的數目必須等於脈衝碼調變 (PCM) 內容數目與 XMA 內容數目的總和。

## 需求

**標頭：** acphal.h

**程式庫：** acphal.lib

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

## 另請參閱

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


## Related topics

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