Skip to main content

SetShapeSrcCommand function

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

Syntax

Parameters

command   _Inout_
Type: SHAPE_FLOWGRAPH_COMMAND*
初期化する 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 およびオーディオミドルウェアは SHAPE コンポーネントを暗黙的に実装します。ただし、フローグラフを構築することで、XBOX One 本体のオーディオアクセラレーション機能に対する最大限の柔軟性とアクセスが得られます。

Requirements

Header: shapeflowgraph.h Supported platforms: XBOX One ファミリー本体および XBOX Series 本体

See also

SHAPE の概要 shapeflowgraph
最終更新日 2026年8月24日