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

# 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\*](/reference/audio/acphal/structs/shape_contexts)

입력 시, 컨텍스트에는 요청된 컨텍스트 배열의 크기가 포함되어야 합니다. 함수가 성공하면 컨텍스트에 할당된 배열이 채워집니다. [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) 구조체를 참조하세요.

### 반환 값

형식: HRESULT

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

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

## 설명

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

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

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

## 요구 사항

**헤더:** acphal.h

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

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

## 관련 항목

[AcpHalReleaseShapeContexts](/reference/audio/acphal/functions/acphalreleaseshapecontexts)\
[AcpHalCreate](/reference/audio/acphal/functions/acphalcreate)\
[AcpHal](/reference/audio/acphal/acphal_members)