IAudioTreble interface (devicetopology.h)
The IAudioTreble interface provides access to a hardware treble-level control. The client obtains a reference to the IAudioTreble interface of a subunit by calling the IPart::Activate method with parameter refiid set to REFIID IID_IAudioTreble. The call to IPart::Activate succeeds only if the subunit supports the IAudioTreble interface. Only a subunit object that represents a hardware function for controlling the level of the treble frequencies in each channel will support this interface.
The IAudioTreble interface provides per-channel controls for setting and getting the gain or attenuation level of the treble frequencies in the audio stream. If a treble-level hardware control can only attenuate the channels in the audio stream, then the maximum treble level for any channel is 0 dB. If a treble-level control can provide gain (amplification), then the maximum treble level is greater than 0 dB.
Most Windows audio adapter drivers support the Windows Driver Model (WDM) and use kernel-streaming (KS) properties to represent the hardware control parameters in subunits (referred to as KS nodes). The IAudioTreble interface provides convenient access to the KSPROPERTY_AUDIO_TREBLE property of a subunit that has a subtype GUID value of KSNODETYPE_TONE. To obtain the subtype GUID of a subunit, call the IPart::GetSubType method. For more information about KS properties and KS node types, see the Windows DDK documentation.
Inheritance
The IAudioTreble interface inherits from the IPerChannelDbLevel interface.
Requirements
| Requirement | Value |
|---|---|
| Minimum supported client | Windows Vista [desktop apps only] |
| Minimum supported server | Windows Server 2008 [desktop apps only] |
| Target Platform | Windows |
| Header | devicetopology.h |