KSPROPERTY_AUDIO_EQ_LEVEL
KSPROPERTY_AUDIO_EQ_LEVEL 属性指定包含 n 个频带条目的均衡表的均衡级别。 这是 EQ 节点 (KSNODETYPE_EQUALIZER) 中的通道的属性。
使用情况摘要表
获取 | 设置 | 目标 | 属性描述符类型 | 属性值类型 |
---|---|---|---|---|
是 |
是 |
筛选器 |
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) |