Lists

[The feature associated with this page, Audio Mixers, is a legacy feature. It has been superseded by Volume Controls. Volume Controls has been optimized for Windows 10 and Windows 11. Microsoft strongly recommends that new code use Volume Controls instead of Audio Mixers, when possible. Microsoft suggests that existing code that uses the legacy APIs be rewritten to use the new APIs if possible.]

The list controls provide single-select or multiple-select states for complex audio lines. These controls use the MIXERCONTROLDETAILS_BOOLEAN structure to retrieve and set control properties. The MIXERCONTROLDETAILS_LISTTEXT structure is also used to retrieve all text descriptions of a multiple-item control. The following table describes the types of list controls.

Control Description
Single-select Restricts the control selection to one item at a time. Unlike the multiplexer control, this control can be used to control more than audio source lines. For example, you could use this control to select a low-pass filter from a list of filters supported by a mixer device.
Multiplexer (MUX) Restricts the line selection to one source line at a time.
Multiple-select Allows the user to select multiple items from a list simultaneously. Unlike the mixer control, the multiple-select control can be used to control more than audio source lines.
Mixer Allows the user to select source lines from a list simultaneously.