KSPROPERTY_AUDIOENGINE_VOLUMELEVEL
KSPROPERTY_AUDIOENGINE_VOLUMELEVEL 属性指定给定流中通道的音量级别。
使用情况摘要表
| 获取 | 设置 | 目标 | 属性描述符类型 | 属性值类型 |
|---|---|---|---|---|
是 |
是 |
通过引脚实例的节点 |
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 |