|
|
|
The KSPROPERTY_AUDIO_VOLUMELEVEL property specifies the volume level of a channel in a volume node (KSNODETYPE_VOLUME).
| Get | Set | Target | Property Descriptor Type | Property Value Type |
|---|---|---|---|---|
| Yes | Yes | Filter/Pin | KSNODEPROPERTY_AUDIO_CHANNEL | LONG |
The property value (operation data) is of type LONG and specifies the volume level. Volume-level values use the following scale:
A decibel range represented by integer values –2147483648 to +2147483647, where
–2147483648 is –Infinity decibels (attenuation),
–2147483647 is –32767.99998474 decibels (attenuation), and
+2147483647 is +32767.99998474 decibels (gain).
This scale has a resolution of 1/65536 decibel.
If a value is specified beyond the range of the filter, the filter will still succeed the request to set this property, but it will return the actual value used in subsequent calls to get this property.
A KSPROPERTY_AUDIO_VOLUMELEVEL property request returns STATUS_SUCCESS to indicate that it has completed successfully. Otherwise, the request returns an appropriate error status code.
Declared in ksmedia.h. Include ksmedia.h.
The property descriptor for this property specifies a channel number. If the stream that passes through the volume node contains n channels, the channels are numbered 0 through n-1. For more information, see Exposing Multichannel Nodes.