KSPROPERTY_AUDIO_EQ_LEVEL

KSPROPERTY_AUDIO_EQ_LEVEL 属性指定包含 n 个频带条目的均衡表的均衡级别。 这是 EQ 节点 (KSNODETYPE_EQUALIZER) 中的通道的属性。

使用情况摘要表

获取 设置 目标 属性描述符类型 属性值类型

筛选器

KSNODEPROPERTY_AUDIO_CHANNEL

LONG 数组

属性值(操作数据)是 LONG 元素数组:

  LONG  Level[N];

如果通道的均衡表包含 N 频率带的条目,则数组包含 N 个元素,并且每个元素指定均衡表中某个带的级别。 下表显示了数组元素的带分配。

数组元素描述级别 [0]

带 0 的级别。

Level[1]

带 1 的级别。

...

Level[N-1]

带 N-1 的级别。

级别值使用以下比例:

-2147483648 为 -Infinity 分贝(衰减),

-2147483647 为 -32767.99998474 分贝(衰减),以及

+2147483647 为 +32767.99998474 分贝(增益)。

由整数值表示的分贝范围 -2147483648 到 +2147483647,其中

此刻度分辨率为 1/65536 分贝。

返回值

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

注解

筛选器将成功执行 KSPROPERTY_AUDIO_EQ_LEVEL set-property 请求,该请求指定超出筛选器范围的值,但会将该值固定为支持的范围。 但是,在后续请求中获取此属性时,它将输出使用的实际值。

可以通过首先提交 KSPROPERTY_AUDIO_NUM_EQ_BANDS 请求来确定均衡带的数目。

均衡带的中心频率由 KSPROPERTY_AUDIO_EQ_BANDS 属性指定。

要求

标头

Ksmedia.h(包括 Ksmedia.h)

另请参阅

KSNODEPROPERTY_AUDIO_CHANNEL

KSNODETYPE_EQUALIZER

KSPROPERTY_AUDIO_NUM_EQ_BANDS

KSPROPERTY_AUDIO_EQ_BANDS