KSPROPERTY_AUDIOENGINE_VOLUMELEVEL

KSPROPERTY_AUDIOENGINE_VOLUMELEVEL属性指定给定流中通道的音量级别。

使用情况摘要表

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

节点 via 引脚实例

KSNODEPROPERTY_AUDIO_CHANNEL

Get 请求的长 () 和 KSAUDIOENGINE_VOLUMELEVEL 请求的 () 。

对于 Get 请求,属性值的类型为 LONG,它指定给定流中通道的卷级别。 卷级别的值使用以下小数位数,可受此属性的基本支持响应中提供的最小值和最大值的限制:

-2147483648 (以十六进制表示的0x80000000,或 LONG_MIN) 为-无限大的分贝 (衰减)

-2147483647 (0x80000001,或 LONG_MIN + 1) 为-32767.99998474 分贝 (衰减) ,

+ 2147483647 (,LONG_MAX) 为 + 32767.99998474 分贝 (获取) 。

注意

分贝范围由从-2147483648 到 + 2147483647 的整数值表示,其中此刻度的分辨率为1/65536 分贝。

对于设置请求,属性值的类型为 KSAUDIOENGINE_VOLUMELEVEL,它指定给定流中的通道所需的音量级别,以及要在设置卷级别时应用的曲线类型和曲线持续时间。 如果在筛选器范围之外指定了某个值,则设置此属性的请求仍将成功。 但应用于筛选器的实际值只能由对此属性的后续调用来确定。

返回值

KSPROPERTY_AUDIOENGINE_SUPPORTEDDEVICEFORMATS属性请求返回STATUS_SUCCESS以指示已成功完成。 否则,请求将返回相应的错误状态代码。

注解

KSPROPERTY_AUDIOENGINE_VOLUMELEVEL的属性描述符指定频道号。 如果穿过音频引擎节点的流包含 n 个通道,通道将从0到 n-1进行编号。 另请注意,如果通道值为0xFFFFFFFF,则表明请求适用于所有通道。 如果在流未处于运行状态时发出了属性请求,则会立即将卷级别设置为请求的级别。 如果流在卷级别斜坡正在进行时仍保持运行状态,则流的卷级别会立即设置为当前淡化的目标级别。 如果在现有的卷级别斜坡正在进行时发出新的属性请求,则新的斜坡请求必须从当前的音量级别开始,即当新请求到达时,已达到了该卷的级别。

要求

版本

Windows 8

标头

Ksmedia.h

另请参阅

KSAUDIOENGINE_VOLUMELEVEL

KSNODEPROPERTY_AUDIO_CHANNEL

KSPROPERTY_AUDIOENGINE

KSPROPERTY_AUDIOENGINE_SUPPORTEDDEVICEFORMATS