展开 最小化

KSPROPERTY_AUDIO_TREBLE

The KSPROPERTY_AUDIO_TREBLE property specifies the treble level for a channel in a tone node (KSNODETYPE_TONE).

Usage Summary Table

GetSetTargetProperty descriptor typeProperty 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)

See also

KSNODEPROPERTY_AUDIO_CHANNEL
KSNODETYPE_TONE

 

 

Send comments about this topic to Microsoft

显示:
© 2014 Microsoft