Skip to content

Latest commit

 

History

History
115 lines (79 loc) · 6.98 KB

ns-mmeapi-mixerlinecontrolsw.md

File metadata and controls

115 lines (79 loc) · 6.98 KB
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.tagMIXERLINECONTROLSW
MIXERLINECONTROLSW (mmeapi.h)
The MIXERLINECONTROLS structure contains information about the controls of an audio line. (MIXERLINECONTROLSW)
*LPMIXERLINECONTROLSW
*PMIXERLINECONTROLSW
MIXERLINECONTROLS
MIXERLINECONTROLS structure [Windows Multimedia]
MIXERLINECONTROLSW
_win32_MIXERLINECONTROLS_str
mmeapi/MIXERLINECONTROLS
multimedia.mixerlinecontrols
tMIXERLINECONTROLS
tagMIXERLINECONTROLSA
tagMIXERLINECONTROLSW
multimedia\mixerlinecontrols.htm
Multimedia
a028785b-2d58-41da-825b-32e98fb44405
12/05/2018
*LPMIXERLINECONTROLSW, *PMIXERLINECONTROLSW, MIXERLINECONTROLS, MIXERLINECONTROLS structure [Windows Multimedia], MIXERLINECONTROLSW, _win32_MIXERLINECONTROLS_str, mmeapi/MIXERLINECONTROLS, multimedia.mixerlinecontrols, tMIXERLINECONTROLS, tagMIXERLINECONTROLSA, tagMIXERLINECONTROLSW
mmeapi.h
Windows
Windows 2000 Professional [desktop apps only]
Windows 2000 Server [desktop apps only]
Windows
MIXERLINECONTROLSW, *PMIXERLINECONTROLSW, *LPMIXERLINECONTROLSW
19H1
tagMIXERLINECONTROLSW
mmeapi/tagMIXERLINECONTROLSW
PMIXERLINECONTROLSW
mmeapi/PMIXERLINECONTROLSW
MIXERLINECONTROLSW
mmeapi/MIXERLINECONTROLSW
c++
APIRef
kbSyntax
HeaderDef
mmeapi.h
MIXERLINECONTROLS
MIXERLINECONTROLSW

MIXERLINECONTROLSW structure

-description

The MIXERLINECONTROLS structure contains information about the controls of an audio line.

-struct-fields

-field cbStruct

Size, in bytes, of the MIXERLINECONTROLS structure. This member must be initialized before calling the mixerGetLineControls function. The size specified in this member must be large enough to contain the MIXERLINECONTROLS structure. When mixerGetLineControls returns, this member contains the actual size of the information returned. The returned information will not exceed the requested size, nor will it be smaller than the MIXERLINECONTROLS structure.

-field dwLineID

Line identifier for which controls are being queried. This member is not used if the MIXER_GETLINECONTROLSF_ONEBYID flag is specified for the mixerGetLineControls function, but the mixer device still returns this member in this case. The dwControlID and dwControlType members are not used when MIXER_GETLINECONTROLSF_ALL is specified.

-field DUMMYUNIONNAME

-field DUMMYUNIONNAME.dwControlID

Control identifier of the desired control. This member is used with the MIXER_GETLINECONTROLSF_ONEBYID flag for the mixerGetLineControls function to retrieve the control information of the specified control. Note that the dwLineID member of the MIXERLINECONTROLS structure will be returned by the mixer device and is not required as an input parameter. This member overlaps with the dwControlType member and cannot be used in conjunction with the MIXER_GETLINECONTROLSF_ONEBYTYPE query type.

-field DUMMYUNIONNAME.dwControlType

Class of the desired Control Types. This member is used with the MIXER_GETLINECONTROLSF_ONEBYTYPE flag for the mixerGetLineControls function to retrieve the first control of the specified class on the line specified by the dwLineID member of the MIXERLINECONTROLS structure. This member overlaps with the dwControlID member and cannot be used in conjunction with the MIXER_GETLINECONTROLSF_ONEBYID query type. See dwControlType member description in MIXERCONTROL.

-field cControls

Number of MIXERCONTROL structure elements to retrieve. This member must be initialized by the application before calling the mixerGetLineControls function. This member can be 1 only if MIXER_GETLINECONTROLSF_ONEBYID or MIXER_GETLINECONTROLSF_ONEBYTYPE is specified or the value returned in the cControls member of the MIXERLINE structure returned for an audio line. This member cannot be zero. If an audio line specifies that it has no controls, mixerGetLineControls should not be called.

-field cbmxctrl

Size, in bytes, of a single MIXERCONTROL structure. The size specified in this member must be at least large enough to contain the base MIXERCONTROL structure. The total size, in bytes, required for the buffer pointed to by the pamxctrl member is the product of the cbmxctrl and cControls members of the MIXERLINECONTROLS structure.

-field pamxctrl

Pointer to one or more MIXERCONTROL structures to receive the properties of the requested audio line controls. This member cannot be NULL and must be initialized before calling the mixerGetLineControls function. Each element of the array of controls must be at least large enough to contain a base MIXERCONTROL structure. The cbmxctrl member must specify the size, in bytes, of each element in this array. No initialization of the buffer pointed to by this member is required by the application. All members are filled in by the mixer device (including the cbStruct member of each MIXERCONTROL structure) upon returning successfully.

-see-also

Audio Mixer Structures

Audio Mixers

MIXERCONTROL

MIXERLINE

mixerGetLineControls

-remarks

Note

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