SetShapeDmaFloatSamples
オーディオ バッファー内のサンプルが浮動小数点データか 32 ビット整数データかを示すフラグを設定します。構文
パラメーター
context _Inout_型: SHAPE_DMA_CONTEXT* SHAPE_DMA_CONTEXT 構造体へのポインター。 floatSamples
型: bool 浮動小数点フラグ: 1 == 浮動小数点データ、0 == 32 ビット整数データ。
戻り値
型: HRESULT HRESULT の成功またはエラー コード。解説
Direct Memory Access (DMA) システムは、float と整数の自動変換 (float から整数、および整数から float) を伴う読み書き機能をサポートします。DMA システムは、128 サンプル ブロックのデインターリーブされたサンプルを含む循環バッファーを使用します。 DMA プロセッサにより、Scalable Hardware Audio Processing Engine (SHAPE) は、ミックス バッファーからメイン システム メモリへのデータの送信、およびさらなる処理のためのメイン システムからミックス バッファーへのデータの取得を行えます。DMA はブロック単位で行われ、一度に 1 オーディオ フレーム分のデータを転送します。ブロック インターリーブ データを扱えるようにするため、サンプルの読み書き時にシステム メモリ内でスキップするオーディオ フレーム ブロック数 (ベース アドレスからの) を指定するスキップ値があります。したがって、マルチチャネル ストリームではチャネルごとに 1 つの DMA コンテキストが必要になります。 オーディオ データ サンプルは常に 32 ビット値として読み書きされ、整数または float のいずれかで、SHAPE_DMA_CONTEXT 構造体のfloatConvert フラグで指定します。DMA の方向 (読み取り/書き込み) は、DMA コンテキストではなく DMA コマンドで指定されることに注意してください。これによりデータ帯域幅の削減に寄与します。DMA エンジンは信号処理を行いませんが、float から整数への変換 (または整数から float への変換) を実行できます。これにより、アプリケーションの CPU は浮動小数点形式でデータ サンプルを処理できます。
要件
ヘッダー: shapedmacontext.h サポートされるプラットフォーム: XBOX One ファミリ本体および XBOX Series 本体関連項目
SHAPE の概要ShapeDmaContext