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

# SetShapePcmAudioBuffer function

> SetShapePcmAudioBuffer function

# SetShapePcmAudioBuffer function

PCM オーディオバッファーを設定します。

これは仮想ポインターを受け取るオーバーロード関数です。[SetShapePcmAudioBuffer](/reference/audio/shapepcmcontext/functions/setshapepcmaudiobuffer_2) は物理アドレスを受け取ります。

## 構文

```cpp theme={null}
HRESULT SetShapePcmAudioBuffer(  
         SHAPE_PCM_CONTEXT* context,  
         const void* audioBuffer  
)  
```

### パラメーター

*context*   \_Inout\_\
型: [SHAPE\_PCM\_CONTEXT\*](/reference/audio/shapepcmcontext/structs/shape_pcm_context)

[SHAPE\_PCM\_CONTEXT](/reference/audio/shapepcmcontext/structs/shape_pcm_context) 構造体へのポインター。

*audioBuffer*   \_In\_\
型: void\*

オーディオバッファーへのポインター。アライメント要件はバッファーの種類と形式に依存します。

### 戻り値

型: HRESULT

HRESULT の成功またはエラーコード。

## 解説

サンプルレートコンバーター (SRC) ブロックは、システムメモリから 16 ビット、24 ビット、または 32 ビット固定小数点、あるいは 32 ビット浮動小数点の Pulse Code Modulation (PCM) データを読み取り、整数ベースのサンプルレート変換を実行します。出力データはミックスバッファーに書き込まれます。入力データとして、SRC ブロックは XBOX Media Audio (XMA) ハードウェアデコーダーの出力、またはソフトウェアが管理するデータのいずれかを取り込むことができます。SRC ブロックは XMA デコーダーと密接に統合されています。これにより、SRC ブロックはメインメモリを読み取ることなく、XMA デコードバッファーにデコード済み PCM データのサンプルが十分あるかどうかを判断できます。

SRC 処理は通常、楽器のエミュレーション、入力サンプルをソースより 1 オクターブ低くまたは高く変換する処理、あるいはドップラー効果などのエフェクトに使用されます。

SRC はモノラルまたはステレオモードで動作します。PCM データはメモリから読み取られ、サンプルレート変換のために共通の 24 ビット固定小数点形式に変換されます。出力はモードに応じて 1 つまたは 2 つのミックスバッファーに書き込まれます。ステレオデータは、各 32 ビットワードの下位 16 ビットに左チャネル、上位 16 ビットに右チャネルを配置した 16 ビットデータのインターリーブストリームとしてメモリに格納されます。ステレオモードでは、PCM データが読み取られると同時にデインターリーブされます。左チャネルのデータ (偶数番号のサンプル) は処理されて 1 つのミックスバッファーに出力され、右チャネルのデータ (奇数番号のサンプル) はもう 1 つのミックスバッファーに書き込まれます。

## 要件

**ヘッダー:** shapepcmcontext.h

**サポート対象プラットフォーム:** XBOX One ファミリー本体および XBOX Series 本体

## 関連項目

[ACP の概要](/build/console-features/audio/overviews/acp-overview)\
[Shape の概要](/build/console-features/audio/overviews/shape-overview)\
[shapepcmcontext](/reference/audio/shapepcmcontext/shapepcmcontext_members)


## Related topics

- [ShapePcmContext](/ja-jp/reference/audio/shapepcmcontext/shapepcmcontext_members.md)
- [SetShapePcmAudioBuffer](/ja-jp/reference/audio/shapepcmcontext/functions/setshapepcmaudiobuffer_2.md)
- [SetShapePcmBufferFull](/ja-jp/reference/audio/shapepcmcontext/functions/setshapepcmbufferfull.md)
- [SetShapePcmBufferLength](/ja-jp/reference/audio/shapepcmcontext/functions/setshapepcmbufferlength.md)
- [GetShapePcmAudioBuffer](/ja-jp/reference/audio/shapepcmcontext/functions/getshapepcmaudiobuffer.md)