MIXERCONTROLDETAILS_LISTTEXTA structure (mmeapi.h)

The MIXERCONTROLDETAILS_LISTTEXT structure retrieves list text, label text, and/or band-range information for multiple-item controls. This structure is used when the MIXER_GETCONTROLDETAILSF_LISTTEXT flag is specified in the mixerGetControlDetails function.

Syntax

typedef struct tagMIXERCONTROLDETAILS_LISTTEXTA {
  DWORD dwParam1;
  DWORD dwParam2;
  CHAR  szName[MIXER_LONG_NAME_CHARS];
} MIXERCONTROLDETAILS_LISTTEXTA, *PMIXERCONTROLDETAILS_LISTTEXTA, *LPMIXERCONTROLDETAILS_LISTTEXTA;

Members

dwParam1

Control class-specific values. The following control types are listed with their corresponding values:

Name	Description
EQUALIZER	MIXERCONTROL. Bounds dwMinimum member.
MIXER and MUX	MIXERLINEdwLineID member.
MULTIPLESELECT and SINGLESELECT	Undefined; must be zero

dwParam2

See dwParam1.

szName[MIXER_LONG_NAME_CHARS]

Name describing a single item in a multiple-item control. This text can be used as a label or item text, depending on the control class.

Remarks

The following standard control types use this structure for retrieving the item text descriptions on multiple-item controls:

Fader control:

MIXERCONTROL_CONTROLTYPE_EQUALIZER

List controls:

MIXERCONTROL_CONTROLTYPE_MIXER

MIXERCONTROL_CONTROLTYPE_MULTIPLESELECT

MIXERCONTROL_CONTROLTYPE_MUX

MIXERCONTROL_CONTROLTYPE_SINGLESELECT

Note

The mmeapi.h header defines MIXERCONTROLDETAILS_LISTTEXT as an alias that automatically selects the ANSI or Unicode version of this function based on the definition of the UNICODE preprocessor constant. Mixing usage of the encoding-neutral alias with code that is not encoding-neutral can lead to mismatches that result in compilation or runtime errors. For more information, see Conventions for Function Prototypes.

Requirements

Requirement	Value
Minimum supported client	Windows 2000 Professional [desktop apps only]
Minimum supported server	Windows 2000 Server [desktop apps only]
Header	mmeapi.h

See also

Audio Mixer Structures

Audio Mixers

MIXERCONTROL

mixerGetControlDetails

mixerSetControlDetails