KSPROPERTY_AUDIO_MIX_LEVEL_TABLE
KSPROPERTY_AUDIO_MIX_LEVEL_TABLE 属性指定超级混音器节点 (KSNODETYPE_SUPERMIX) 的混音级别。 它提供所有输入和输出通道的信息。
使用情况摘要表
| 获取 | 设置 | 目标 | 属性描述符类型 | 属性值类型 |
|---|---|---|---|---|
是 |
可选 |
固定 |
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 数组元素的索引显示在方括号中。
如果没有路径将输入通道 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 成员），但会（无提示）将值固定为支持的范围。 但是，在后续请求中获取此属性时，筛选器将输出使用的实际值。
要求
标头 |
Ksmedia.h（包括 Ksmedia.h） |