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

# SetShapeSrcCommand function

> SetShapeSrcCommand function

# SetShapeSrcCommand function

SHAPE SRC コマンドを初期化します。

## Syntax

```cpp theme={null}
HRESULT SetShapeSrcCommand(  
         SHAPE_FLOWGRAPH_COMMAND* command,  
         UINT32 contextId,  
         UINT32 leftorMonoMixBuffer,  
         UINT32 rightMixBuffer  
)  
```

### Parameters

*command*   \_Inout\_\
Type: SHAPE\_FLOWGRAPH\_COMMAND\*

初期化する [SHAPE\_FLOWGRAPH\_COMMAND](/reference/audio/shapeflowgraph/structs/shape_flowgraph_command) コマンド。

*contextId*   \
Type: UINT32

このコマンドが参照する SRC コンテキスト ID (インデックス)。

*leftorMonoMixBuffer*   \
Type: UINT32

入力ミックスバッファー ID。

*rightMixBuffer*   \
Type: UINT32

出力ミックスバッファー ID。

### Return value

Type: HRESULT

関数が成功した場合は `S_OK` を返します。1 つ以上の引数が無効な場合は `E_INVALIDARG` を返します。

## Remarks

フローグラフは、永続的または非永続的として処理のためにサブミットできます。永続的なフローグラフは処理を実行し、その後もメモリに常駐し、読み取り/書き込みポインターの進行および他のコンテキスト情報の更新後に、次のフレームで同じ処理を繰り返します。以下のシナリオのいずれかで永続的なフローグラフを使用できます。

* **非常に複雑なフローグラフ**: 各フレームの再アセンブルに大量の CPU 処理が必要な場合。
* **非常に静的なフローグラフ**: ボイスの数と構成が長期間同じ場合。

以下のシナリオでは非永続的なフローグラフを使用します。

* ボイスのトポロジーが頻繁に変化する。
* タイトルのオーディオソフトウェアエンジンの処理間隔が SHAPE ハードウェアから分離しており、2.667 ms の倍数でない。
* リアルタイムよりも高速にオーディオ処理を実行し、グラフが利用可能になるとすぐに消費するようにサブミットしたい場合。

多くのタイトルはフローグラフを直接実装しません。[XAudio2](/build/console-features/audio/overviews/xaudio2-overview) およびオーディオミドルウェアは SHAPE コンポーネントを暗黙的に実装します。ただし、フローグラフを構築することで、XBOX One 本体のオーディオアクセラレーション機能に対する最大限の柔軟性とアクセスが得られます。

## Requirements

**Header:** shapeflowgraph.h

**Supported platforms:** XBOX One ファミリー本体および XBOX Series 本体

## See also

[SHAPE の概要](/build/console-features/audio/overviews/shape-overview)

[shapeflowgraph](/reference/audio/shapeflowgraph/shapeflowgraph_members)


## Related topics

- [ShapeFlowGraph](/ja-jp/reference/audio/shapeflowgraph/shapeflowgraph_members.md)
- [SetShapeSrcCommand](/ja-jp/reference/audio/shapesrccontext/functions/shapesrccontext_setshapesrccommand.md)
- [SHAPE_SRC_COMMAND_TYPE](/ja-jp/reference/audio/shapesrccontext/enums/shape_src_command_type.md)
- [GetShapeSrcCommandType](/ja-jp/reference/audio/shapesrccontext/functions/getshapesrccommandtype.md)
- [ShapeSrcContext](/ja-jp/reference/audio/shapesrccontext/shapesrccontext_members.md)