IAMAudioInputMixer interface (strmif.h)
[The feature associated with this page, DirectShow, is a legacy feature. It has been superseded by MediaPlayer, IMFMediaEngine, and Audio/Video Capture in Media Foundation. Those features have been optimized for Windows 10 and Windows 11. Microsoft strongly recommends that new code use MediaPlayer, IMFMediaEngine and Audio/Video Capture in Media Foundation instead of DirectShow, when possible. Microsoft suggests that existing code that uses the legacy APIs be rewritten to use the new APIs if possible.]
The IAMAudioInputMixer interface controls audio capture properties, such as panning and loudness; and enables or disables specific audio inputs, such as the line in or the microphone.
The Audio Capture filter exposes this interface on each input pin, as well as on the filter itself. The input pins on the Audio Capture Filter represent physical hardware connections; they are not connected to other DirectShow filters. The pin name indicates the input type; for example, "Line In" or "Microphone." Use the IAMAudioInputMixer interface as follows:
- To control the settings on a particular input, use the interface on the pin.
- To set the overall properties when multiple inputs are enabled, use the interface on the filter.
- To enable or disable an input, call that pin's IAMAudioInputMixer::put_Enable method.
Filter Developers: Implement this interface on each input pin of an audio capture filter. You can also implement this interface on the audio capture filter itself to control the overall audio settings after mixing.
Inheritance
The IAMAudioInputMixer interface inherits from the IUnknown interface. IAMAudioInputMixer also has these types of members:
Methods
The IAMAudioInputMixer interface has these methods.
| IAMAudioInputMixer::get_Bass The get_Bass method retrieves the bass equalization. |
| IAMAudioInputMixer::get_BassRange The get_BassRange method retrieves the bass range. |
| IAMAudioInputMixer::get_Enable The get_Enable method retrieves whether the input is enabled. |
| IAMAudioInputMixer::get_Loudness The get_Loudness method retrieves the loudness control setting. |
| IAMAudioInputMixer::get_MixLevel The get_MixLevel method retrieves the recording level. |
| IAMAudioInputMixer::get_Mono The get_Mono method queries whether all channels are combined into a mono signal. |
| IAMAudioInputMixer::get_Pan The get_Pan method retrieves the pan level. |
| IAMAudioInputMixer::get_Treble The get_Treble method retrieves the treble equalization. |
| IAMAudioInputMixer::get_TrebleRange The get_TrebleRange method retrieves the treble range for this input. |
| IAMAudioInputMixer::put_Bass The put_Bass method sets the bass equalization. |
| IAMAudioInputMixer::put_Enable The put_Enable method enables or disables an input. |
| IAMAudioInputMixer::put_Loudness The put_Loudness method enables or disables the loudness control. |
| IAMAudioInputMixer::put_MixLevel The put_MixLevel method sets the recording level for this input. |
| IAMAudioInputMixer::put_Mono The put_Mono method combines all channels into a mono signal. |
| IAMAudioInputMixer::put_Pan The put_Pan method sets the pan level. |
| IAMAudioInputMixer::put_Treble The put_Treble method sets the treble equalization for this input. |
Requirements
| Requirement | Value |
|---|---|
| Minimum supported client | Windows 2000 Professional [desktop apps only] |
| Minimum supported server | Windows 2000 Server [desktop apps only] |
| Target Platform | Windows |
| Header | strmif.h (include Dshow.h) |