> ## 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              | 1 つ以上の引数が無効です。         |
| E\_OUTOFMEMORY             | メモリ割り当てに失敗しました。        |
| ACP\_E\_ALREADY\_ALLOCATED | コンテキスト配列は既に割り当てられています。 |

## 備考

このメソッドは、[AcpHalCreate](/reference/audio/acphal/functions/acphalcreate) を呼び出す前に、Audio Control Processor (ACP) クライアント用のコンテキストを割り当てるために呼び出します。

その後 [AcpHalReleaseShapeContexts](/reference/audio/acphal/functions/acphalreleaseshapecontexts) が呼び出されない限り、このメソッドは 1 度だけ呼び出す必要があります。

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)


## Related topics

- [SHAPE_CONTEXTS](/ja-jp/reference/audio/acphal/structs/shape_contexts.md)
- [AcpHalReleaseShapeContexts](/ja-jp/reference/audio/acphal/functions/acphalreleaseshapecontexts.md)
- [AcpHal](/ja-jp/reference/audio/acphal/acphal_members.md)
- [AcpHalCreate](/ja-jp/reference/audio/acphal/functions/acphalcreate.md)
- [IAcpHal::Connect](/ja-jp/reference/audio/acphal/interfaces/IAcpHal/methods/iacphal_connect.md)