Skip to content

Latest commit

 

History

History
277 lines (210 loc) · 10.5 KB

ns-mmeapi-mixercontrola.md

File metadata and controls

277 lines (210 loc) · 10.5 KB
Raw
UID title description helpviewer_keywords old-location tech.root ms.assetid ms.date ms.keywords req.header req.include-header req.target-type req.target-min-winverclnt req.target-min-winversvr req.kmdf-ver req.umdf-ver req.ddi-compliance req.unicode-ansi req.idl req.max-support req.namespace req.assembly req.type-library req.lib req.dll req.irql targetos req.typenames req.redist ms.custom f1_keywords dev_langs topic_type api_type api_location api_name
NS:mmeapi.tagMIXERCONTROLA
MIXERCONTROLA (mmeapi.h)
The MIXERCONTROL structure describes the state and metrics of a single control for an audio line. (mixercontrola)
*LPMIXERCONTROLA
*PMIXERCONTROLA
MIXERCONTROL
MIXERCONTROL structure [Windows Multimedia]
MIXERCONTROL
*PMIXERCONTROL
FAR *PMIXERCONTROL
MIXERCONTROL
*PMIXERCONTROL
FAR *PMIXERCONTROL structure [Windows Multimedia]
MIXERCONTROLA
MIXERCONTROL_CONTROLF_DISABLED
MIXERCONTROL_CONTROLF_MULTIPLE
MIXERCONTROL_CONTROLF_UNIFORM
MIXERCONTROL_CT_CLASS_CUSTOM
MIXERCONTROL_CT_CLASS_FADER
MIXERCONTROL_CT_CLASS_LIST
MIXERCONTROL_CT_CLASS_METER
MIXERCONTROL_CT_CLASS_NUMBER
MIXERCONTROL_CT_CLASS_SLIDER
MIXERCONTROL_CT_CLASS_SWITCH
MIXERCONTROL_CT_CLASS_TIME
_win32_MIXERCONTROL_str
mmeapi/MIXERCONTROL
multimedia.mixercontrol
tMIXERCONTROL
tagMIXERCONTROLA
tagMIXERCONTROLW
multimedia\mixercontrol.htm
Multimedia
2ddbcf82-9204-43c6-8235-8bce6a55bb36
12/05/2018
*LPMIXERCONTROLA, *PMIXERCONTROLA, MIXERCONTROL, MIXERCONTROL structure [Windows Multimedia], MIXERCONTROL,*PMIXERCONTROL,FAR *PMIXERCONTROL, MIXERCONTROL,*PMIXERCONTROL,FAR *PMIXERCONTROL structure [Windows Multimedia], MIXERCONTROLA, MIXERCONTROL_CONTROLF_DISABLED, MIXERCONTROL_CONTROLF_MULTIPLE, MIXERCONTROL_CONTROLF_UNIFORM, MIXERCONTROL_CT_CLASS_CUSTOM, MIXERCONTROL_CT_CLASS_FADER, MIXERCONTROL_CT_CLASS_LIST, MIXERCONTROL_CT_CLASS_METER, MIXERCONTROL_CT_CLASS_NUMBER, MIXERCONTROL_CT_CLASS_SLIDER, MIXERCONTROL_CT_CLASS_SWITCH, MIXERCONTROL_CT_CLASS_TIME, _win32_MIXERCONTROL_str, mmeapi/MIXERCONTROL, multimedia.mixercontrol, tMIXERCONTROL, tagMIXERCONTROLA, tagMIXERCONTROLW
mmeapi.h
Windows
Windows 2000 Professional [desktop apps only]
Windows 2000 Server [desktop apps only]
Windows
MIXERCONTROLA, *PMIXERCONTROLA, *LPMIXERCONTROLA
19H1
tagMIXERCONTROLA
mmeapi/tagMIXERCONTROLA
PMIXERCONTROLA
mmeapi/PMIXERCONTROLA
MIXERCONTROLA
mmeapi/MIXERCONTROLA
c++
APIRef
kbSyntax
HeaderDef
mmeapi.h
MIXERCONTROL, *PMIXERCONTROL, FAR *PMIXERCONTROL
mixercontrola

MIXERCONTROLA structure

-description

The MIXERCONTROL structure describes the state and metrics of a single control for an audio line.

-struct-fields

-field cbStruct

Size, in bytes, of the MIXERCONTROL structure.

-field dwControlID

Audio mixer-defined identifier that uniquely refers to the control described by the MIXERCONTROL structure. This identifier can be in any format supported by the mixer device. An application should use this identifier only as an abstract handle. No two controls for a single mixer device can ever have the same control identifier.

-field dwControlType

Class of the control for which the identifier is specified in dwControlID. An application must use this information to display the appropriate control for input from the user. An application can also display tailored graphics based on the control class or search for a particular control class on a specific line. If an application does not know about a control class, this control must be ignored. There are eight control class classifications, each with one or more standard control types:

Name Descriptions
MIXERCONTROL_CT_CLASS_CUSTOM
 MIXERCONTROL_CONTROLTYPE_CUSTOM
MIXERCONTROL_CT_CLASS_FADER
 MIXERCONTROL_CONTROLTYPE_BASS MIXERCONTROL_CONTROLTYPE_EQUALIZER MIXERCONTROL_CONTROLTYPE_FADER MIXERCONTROL_CONTROLTYPE_TREBLE MIXERCONTROL_CONTROLTYPE_VOLUME
MIXERCONTROL_CT_CLASS_LIST
 MIXERCONTROL_CONTROLTYPE_MIXER MIXERCONTROL_CONTROLTYPE_MULTIPLESELECT MIXERCONTROL_CONTROLTYPE_MUX MIXERCONTROL_CONTROLTYPE_SINGLESELECT
MIXERCONTROL_CT_CLASS_METER
 MIXERCONTROL_CONTROLTYPE_BOOLEANMETER MIXERCONTROL_CONTROLTYPE_PEAKMETER MIXERCONTROL_CONTROLTYPE_SIGNEDMETER MIXERCONTROL_CONTROLTYPE_UNSIGNEDMETER
MIXERCONTROL_CT_CLASS_NUMBER
 MIXERCONTROL_CONTROLTYPE_DECIBELS MIXERCONTROL_CONTROLTYPE_PERCENT MIXERCONTROL_CONTROLTYPE_SIGNED MIXERCONTROL_CONTROLTYPE_UNSIGNED
MIXERCONTROL_CT_CLASS_SLIDER
 MIXERCONTROL_CONTROLTYPE_PAN MIXERCONTROL_CONTROLTYPE_QSOUNDPAN MIXERCONTROL_CONTROLTYPE_SLIDER
MIXERCONTROL_CT_CLASS_SWITCH
 MIXERCONTROL_CONTROLTYPE_BOOLEAN MIXERCONTROL_CONTROLTYPE_BUTTON MIXERCONTROL_CONTROLTYPE_LOUDNESS MIXERCONTROL_CONTROLTYPE_MONO MIXERCONTROL_CONTROLTYPE_MUTE MIXERCONTROL_CONTROLTYPE_ONOFF MIXERCONTROL_CONTROLTYPE_STEREOENH
MIXERCONTROL_CT_CLASS_TIME
 MIXERCONTROL_CONTROLTYPE_MICROTIME MIXERCONTROL_CONTROLTYPE_MILLITIME

-field fdwControl

Status and support flags for the audio line control. The following values are defined:

Name Description
MIXERCONTROL_CONTROLF_DISABLED
 The control is disabled, perhaps due to other settings for the mixer hardware, and cannot be used. An application can read current settings from a disabled control, but it cannot apply settings.
MIXERCONTROL_CONTROLF_MULTIPLE
 The control has two or more settings per channel. An equalizer, for example, requires this flag because each frequency band can be set to a different value. An equalizer that affects both channels of a stereo line in a uniform fashion will also specify the MIXERCONTROL_CONTROLF_UNIFORM flag.
MIXERCONTROL_CONTROLF_UNIFORM
 The control acts on all channels of a multichannel line in a uniform fashion. For example, a control that mutes both channels of a stereo line would set this flag. Most MIXERCONTROL_CONTROLTYPE_MUX and MIXERCONTROL_CONTROLTYPE_MIXER controls also specify the MIXERCONTROL_CONTROLF_UNIFORM flag.

-field cMultipleItems

Number of items per channel that make up a MIXERCONTROL_CONTROLF_MULTIPLE control. This number is always two or greater for multiple-item controls. If the control is not a multiple-item control, do not use this member; it will be zero.

-field szShortName

Short string that describes the audio line control specified by dwControlID. This description should be appropriate to use as a concise label for the control.

-field szName

String that describes the audio line control specified by dwControlID. This description should be appropriate to use as a complete description for the control.

-field Bounds

Union of boundary types.

-field Bounds.DUMMYSTRUCTNAME

-field Bounds.DUMMYSTRUCTNAME.lMinimum

Minimum signed value for a control that has a signed boundary nature. This member cannot be used in conjunction with dwMinimum.

-field Bounds.DUMMYSTRUCTNAME.lMaximum

Maximum signed value for a control that has a signed boundary nature. This member cannot be used in conjunction with dwMaximum.

-field Bounds.DUMMYSTRUCTNAME2

-field Bounds.DUMMYSTRUCTNAME2.dwMinimum

Minimum unsigned value for a control that has an unsigned boundary nature. This member cannot be used in conjunction with lMinimum.

-field Bounds.DUMMYSTRUCTNAME2.dwMaximum

Maximum unsigned value for a control that has an unsigned boundary nature. This member cannot be used in conjunction with lMaximum.

-field Bounds.dwReserved

Reserved; do not use.

-field Metrics

Union of boundary metrics.

-field Metrics.cSteps

Number of discrete ranges within the union specified for a control specified by the Bounds member. This member overlaps with the other members of the Metrics structure member and cannot be used in conjunction with those members.

-field Metrics.cbCustomData

Size, in bytes, required to contain the state of a custom control class. This member is appropriate only for the MIXERCONTROL_CONTROLTYPE_CUSTOM control class.

-field Metrics.dwReserved

Reserved; do not use.

-see-also

Audio Mixer Structures

Audio Mixers

MIXERLINECONTROLS

mixerGetLineControls

-remarks

Note

The mmeapi.h header defines MIXERCONTROL 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.