Edit

MIXERCONTROLDETAILS_LISTTEXTW structure (mmeapi.h)

  • Article

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_LISTTEXTW {
  DWORD dwParam1;
  DWORD dwParam2;
  WCHAR szName[MIXER_LONG_NAME_CHARS];
} MIXERCONTROLDETAILS_LISTTEXTW, *PMIXERCONTROLDETAILS_LISTTEXTW, *LPMIXERCONTROLDETAILS_LISTTEXTW;

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 which 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 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