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 |