KSPROPERTY_AUDIO_MIX_LEVEL_TABLE

项目
02/23/2024

KSPROPERTY_AUDIO_MIX_LEVEL_TABLE 属性指定超级混音器节点 (KSNODETYPE_SUPERMIX) 的混音级别。它提供所有输入和输出通道的信息。

使用情况摘要表

获取	设置	目标	属性描述符类型	属性值类型
是	可选	固定	KSNODEPROPERTY	KSAUDIO_MIXLEVEL 结构的数组

需要节点才能实现对 KSPROPERTY_TYPE_GET 请求的支持。但是，对 KSPROPERTY_TYPE_SET 请求的支持是可选的。

属性值（操作数据）是 KSAUDIO_MIXLEVEL 结构的数组，用于指定具有 M 输入通道和 N 输出通道的超级混音器节点中所有 M*N 输入输出路径的混音级别。该数组包含 M*N 个元素：

  KSAUDIO_MIXLEVEL  MixLevel[M*N];

下表显示了数组元素到超级混音器节点的 M*N 输入输出路径的映射。

数组元素	输入-输出路径
MixLevel[0]	输入通道 0 到输出通道 0
MixLevel[1]	输入通道 0 到输出通道 1
MixLevel[N-1]	输入通道 0 到输出通道 N-1
MixLevel[N]	输入通道 1 到输出通道 0
MixLevel[N+1]	输入通道 1 到输出通道 1
MixLevel[2N-1]	输入通道 1 到输出通道 N-1
MixLevel[M*N-1]	输入通道 M-1 到输出通道 N-1

下图演示了 MixLevel 数组元素到输入-输出路径的映射。控制每个输入-输出路径的 MixLevel 数组元素的索引显示在方括号中。

Diagram illustrating the mapping of a supermixer node's MixLevel array elements to input-output paths.

如果没有路径将输入通道 i 连接到输出通道 j，筛选器应将数组元素 MixLevel[i*N+j] 的 Mute 成员设置为 TRUE。

KSAUDIO_MIXLEVEL 数组的大小根据从 KSPROPERTY_AUDIO_MIX_LEVEL_CAPS 中检索的 KSAUDIO_MIXCAP_TABLE 结构计算。如果结构的 InputChannels 和 OutputChannels 成员包含值 m 和 n，则数组大小为

m * n * sizeof(KSAUDIO_MIXLEVEL)

返回值

KSPROPERTY_AUDIO_MIX_LEVEL_TABLE 属性请求返回 STATUS_SUCCESS，以指示它已成功完成。否则，请求将返回适当的错误状态代码。

注解

筛选器将成功执行 KSPROPERTY_AUDIO_MIX_LEVEL_TABLE set-property 请求，该请求指定超出筛选器范围的混音级别值（KSAUDIO_MIXLEVEL 的 Level 成员），但会（无提示）将值固定为支持的范围。但是，在后续请求中获取此属性时，筛选器将输出使用的实际值。