Skip to main content

AcpHalAllocateShapeContexts

Scalable Hardware Audio Processing Engine (SHAPE) および XBOX Media Audio (XMA) 用のコンテキスト配列を割り当てます。

構文

パラメーター

contextArrays   _Inout_
型: SHAPE_CONTEXTS*
入力時、コンテキストにはコンテキスト配列の要求サイズが含まれている必要があります。関数が成功すると、コンテキストに割り当てられた配列が設定されます。SHAPE_DMA_CONTEXTSHAPE_EQCOMP_CONTEXTSHAPE_FILTVOL_CONTEXTSHAPE_PCM_CONTEXTSHAPE_SRC_CONTEXT、および SHAPE_XMA_CONTEXT の各構造体を参照してください。

戻り値

型: HRESULT メソッドが成功した場合は S_OK を返します。メソッドが失敗した場合は、次のいずれかのコードを返します (一部抜粋)。

備考

このメソッドは、AcpHalCreate を呼び出す前に、Audio Control Processor (ACP) クライアント用のコンテキストを割り当てるために呼び出します。 その後 AcpHalReleaseShapeContexts が呼び出されない限り、このメソッドは 1 度だけ呼び出す必要があります。 Sample Rate Convertor (SRC) コンテキストの数は、pulse-code modulation (PCM) コンテキストの数と XMA コンテキストの数の合計と等しくなければなりません。

要件

ヘッダー: acphal.h ライブラリ: acphal.lib サポートされているプラットフォーム: XBOX One 系コンソールおよび XBOX Series コンソール

関連項目

AcpHalReleaseShapeContexts
AcpHalCreate
AcpHal
最終更新日 2026年8月24日