KSPROPERTY_AUDIOENGINE_VOLUMELEVEL

  • 项目

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

使用情况摘要表

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

是

是

通过引脚实例的节点

KSNODEPROPERTY_AUDIO_CHANNEL

LONG（对于 Get 请求）和 KSAUDIOENGINE_VOLUMELEVEL（对于 Set 请求）。

对于 Get 请求，属性值为 LONG 类型，它指定给定流中通道的音量级别。 音量级别值使用以下小数位数，并且可以受此属性的基本支持响应中提供的最小值和最大值的约束：

-2147483648（十六进制或 LONG_MIN 中的 0x80000000）为 -Infinity 分贝（衰减），

-2147483647（十六进制或 LONG_MIN + 1 中的 0x80000001）为 -32767.99998474 分贝（衰减），以及

+2147483647（十六进制或 LONG_MAX 中的0x7FFFFFFF）为 +32767.99998474 分贝（增益）。

注意

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

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

返回值

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