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

Scalable Hardware Audio Processing Engine(SHAPE) 및 XBOX Media Audio(XMA)에 대한 컨텍스트 배열을 할당합니다.

## 구문

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

### 매개 변수

*contextArrays*   \_Inout\_\
형식: [SHAPE\_CONTEXTS\*](https://docs.xbox.com/ko/reference/audio/acphal/structs/shape_contexts.md)

입력 시, 컨텍스트에는 요청된 컨텍스트 배열의 크기가 포함되어야 합니다. 함수가 성공하면 컨텍스트에 할당된 배열이 채워집니다. [SHAPE\_DMA\_CONTEXT](https://docs.xbox.com/ko/reference/audio/shapedmacontext/structs/shape_dma_context.md), [SHAPE\_EQCOMP\_CONTEXT](https://docs.xbox.com/ko/reference/audio/shapeeqcompcontext/structs/shape_eqcomp_context.md), [SHAPE\_FILTVOL\_CONTEXT](https://docs.xbox.com/ko/reference/audio/shapefiltvolcontext/structs/shape_filtvol_context.md), [SHAPE\_PCM\_CONTEXT](https://docs.xbox.com/ko/reference/audio/shapepcmcontext/structs/shape_pcm_context.md), [SHAPE\_SRC\_CONTEXT](https://docs.xbox.com/ko/reference/audio/shapesrccontext/structs/shape_src_context.md), [SHAPE\_XMA\_CONTEXT](https://docs.xbox.com/ko/reference/audio/shapexmacontext/structs/shape_xma_context.md) 구조체를 참조하세요.

### 반환 값

형식: HRESULT

메서드가 성공하면 `S_OK`를 반환합니다. 메서드가 실패하면 다음 코드 중 하나를 반환합니다(부분 목록):

| 반환 코드 | 설명 |
| - | - |
| E\_INVALIDARG | 하나 이상의 인수가 유효하지 않습니다. |
| E\_OUTOFMEMORY | 메모리 할당에 실패했습니다. |
| ACP\_E\_ALREADY\_ALLOCATED | 컨텍스트 배열이 이미 할당되었습니다. |

## 설명

Audio Control Processor(ACP) 클라이언트에 대한 컨텍스트를 할당하려면 [AcpHalCreate](https://docs.xbox.com/ko/reference/audio/acphal/functions/acphalcreate.md)를 호출하기 전에 이 메서드를 호출합니다.

[AcpHalReleaseShapeContexts](https://docs.xbox.com/ko/reference/audio/acphal/functions/acphalreleaseshapecontexts.md)에 대한 후속 호출이 없는 한 이 메서드는 한 번만 호출해야 합니다.

Sample Rate Convertor(SRC) 컨텍스트의 수는 pulse-code modulation(PCM) 컨텍스트 수와 XMA 컨텍스트 수의 합과 같아야 합니다.

## 요구 사항

**헤더:** acphal.h

**라이브러리:** acphal.lib

**지원 플랫폼:** XBOX One 제품군 콘솔 및 XBOX Series 콘솔

## 관련 항목

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


## Related topics

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