Skip to main content

XApuConnectInputParameters

传递给 XApuConnect 用于分配资源的参数。

Syntax

Members

processType
Type: XApuProcessType
将对 XAPU 客户端处理的所有流执行的处理类型。单个客户端不能执行多种处理类型。 maxStreamCount
Type: uint32_t
预期同时为 XAPU 客户端激活的流的最大数量。最小值为 1,最大值为 500。 maxQueuedCommandsPerStream
Type: uint32_t
一个流的命令队列大小。最小值为 1,最大值为 16。XAPU 客户端的总命令队列大小为 maxStreamCount * maxQueuedCommandsPerStream baseDataLength
Type: uint32_t
处理 maxStreamCount 个流所需的内存分配(以字节为单位),其中包括输入、输出和处理缓冲区。 例如,对于一个具有 20 毫秒数据包(960 帧)的立体声 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
Type: uint32_t
此参数定义当 XAPU 以 XApuProcessType::ConvertPCMXApuProcessType::DecodeConvertOpus 类型运行时的输出时长(以帧数表示)。 对于 XApuProcessType::ConvertPCMXApuProcessType::DecodeConvertOpus,此参数必须设置为以下值之一:256、480、512、960、1024。 对于 XApuProcessType::DecodeOpus,此参数必须设置为零。 options
Type: XApuConnectOptions
连接选项。

Remarks

XApuConnectInputParameters 使用它向 XApuConnect 传递参数。XApuConnect 为音频处理单元 (XAPU) 分配所需资源。XApuCommandId 定义了要发送到 XAPU 或从 XAPU 接收的基本命令参数。

Requirements

头文件: xapu.h 支持的平台: XBOX Series X|S

See also

XApuCommandId
XApuConnect
XApuDecodeConvertCommand
XAPU
最后修改于 2026年8月24日