Skip to main content

XApuConnectInputParameters

リソースを割り当てるために XApuConnect に渡すパラメーター。

構文

メンバー

processType
型: XApuProcessType
XAPU クライアントによって処理されるすべてのストリームに対して実行される処理種別。1 つのクライアントは 2 種類以上の処理種別を実行できません。 maxStreamCount
型: uint32_t
XAPU クライアントで同時にアクティブになると想定されるストリームの最大数。最小値は 1、最大値は 500 です。 maxQueuedCommandsPerStream
型: uint32_t
1 つのストリームのコマンド キュー サイズ。最小値は 1、最大値は 16 です。XAPU クライアントの合計コマンド キュー サイズは、maxStreamCount * maxQueuedCommandsPerStream です。 baseDataLength
型: uint32_t
maxStreamCount 個のストリームを処理するために必要なメモリ割り当てサイズ (バイト単位)。入力、出力、および処理バッファーを含みます。 たとえば、20 ミリ秒パケット (960 フレーム) の 1 つのステレオ Opus ストリームを DecodeOpus する場合の baseDataLength は、 想定される入力パケット長 (バイト単位) の最大値に、出力フレーム数 × チャネル数 × float 型変数のサイズを加えたものになります。 XApuProcessType::DecodeOpus の一般的な計算式は次のとおりです。 baseDataLength = maxStreamCount x maxQueuedCommandsPerStream x (MaxOpusPacketInBytes + (MaxFrameCountPerPacket x ChannelCount x sizeof(float)) ここで MaxFrameCountPerPacket は 16 の倍数である必要があります。 XApuProcessType::DecodeConvertOpus の一般的な計算式は次のとおりです。 baseDataLength = (maxStreamCount x maxQueuedCommandsPerStream x (MaxOpusPacketInBytes + (MaxFrameCountPerPacket x ChannelCount x sizeof(float)))
  • (maxStreamCount x XApuDecodeConvertActivateCommand::processingBufferLength) ここで MaxFrameCountPerPacket は 16 の倍数である必要があります。
maxFrameCountPerOutput
型: uint32_t
このパラメーターは、XAPU が XApuProcessType::ConvertPCM または XApuProcessType::DecodeConvertOpus 種別で実行されているときの出力持続時間をフレーム数で定義します。 XApuProcessType::ConvertPCM または XApuProcessType::DecodeConvertOpus の場合、このパラメーターは 256、480、512、960、1024 のいずれかに設定する必要があります。 このパラメーターは XApuProcessType::DecodeOpus の場合は 0 に設定する必要があります。 options
型: XApuConnectOptions
接続オプション。

解説

XApuConnectInputParameters は、パラメーターを XApuConnect に渡すために使用されます。XApuConnect は Audio Processing Unit (XAPU) のために必要なリソースを割り当てます。XApuCommandId は、XAPU に送信され、XAPU から受信される基本コマンド パラメーターを定義します。

要件

ヘッダー: xapu.h サポートされているプラットフォーム: XBOX Series X|S

関連項目

XApuCommandId
XApuConnect
XApuDecodeConvertCommand
XAPU
最終更新日 2026年8月24日