KSPROPERTY_AUDIO_TREBLE
The KSPROPERTY_AUDIO_TREBLE property specifies the treble level for a channel in a tone node (KSNODETYPE_TONE).
Usage Summary Table
| Get | Set | Target | Property descriptor type | Property value type |
|---|---|---|---|---|
Yes |
Yes |
Filter |
KSNODEPROPERTY_AUDIO_CHANNEL | LONG |
The property value (operation data) is of type LONG and specifies the treble-level setting for the channel. Treble-level values use the following scale:
-2147483648 is -Infinity decibels (attenuation),
-2147483647 is -32767.99998474 decibels (attenuation), and
+2147483647 is +32767.99998474 decibels (gain).
A decibel range represented by integer values -2147483648 to +2147483647, where
This scale has a resolution of 1/65536 decibel.
The filter will succeed a set-property request that specifies a value that is beyond the range of the filter but will clamp the value to the supported range. In a subsequent request to get this property, however, it will return the actual value used.
Return Value
A KSPROPERTY_AUDIO_TREBLE property request returns STATUS_SUCCESS to indicate that it has completed successfully. Otherwise, the request returns an appropriate error status code.
Remarks
A tone node can support properties for controlling treble level, mid-frequency level, bass level, and bass boost. For more information, see KSNODETYPE_TONE.
Requirements
Header |
Ksmedia.h (include Ksmedia.h) |