MIXERLINECONTROLS 结构 (mmeapi.h)
MIXERLINECONTROLS 结构包含有关音频线控件的信息。
语法
typedef struct tMIXERLINECONTROLS {
DWORD cbStruct;
DWORD dwLineID;
union {
DWORD dwControlID;
DWORD dwControlType;
};
DWORD cControls;
DWORD cbmxctrl;
LPMIXERCONTROL pamxctrl;
} MIXERLINECONTROLS, *PMIXERLINECONTROLS, *LPMIXERLINECONTROLS;
成员
cbStruct
MIXERLINECONTROLS 结构的大小（以字节为单位）。 在调用 mixerGetLineControls 函数之前，必须初始化此成员。 此成员中指定的大小必须足够大，才能包含 MIXERLINECONTROLS 结构。 当 mixerGetLineControls 返回时，此成员包含返回的信息的实际大小。 返回的信息不会超过请求的大小，也不会小于 MIXERLINECONTROLS 结构。
dwLineID
查询控件的行标识符。 如果为 mixerGetLineControls 函数指定了MIXER_GETLINECONTROLSF_ONEBYID标志，则不使用此成员，但混音器设备在这种情况下仍返回此成员。 指定MIXER_GETLINECONTROLSF_ALL时，不使用 dwControlID 和 dwControlType 成员。
dwControlID
所需控件的控件标识符。 此成员与 mixerGetLineControls 函数的 MIXER_GETLINECONTROLSF_ONEBYID 标志一起使用，以检索指定控件的控件信息。 请注意，MIXERLINECONTROLS 结构的 dwLineID 成员将由混音器设备返回，不需要作为输入参数。 此成员与 dwControlType 成员重叠，不能与MIXER_GETLINECONTROLSF_ONEBYTYPE查询类型结合使用。
dwControlType
所需 控件类型的类。 此成员与 mixerGetLineControls 函数的 MIXER_GETLINECONTROLSF_ONEBYTYPE 标志一起使用，以便在 MIXERLINECONTROLS 结构的 dwLineID 成员指定的行上检索指定类的第一个控件。 此成员与 dwControlID 成员重叠，不能与MIXER_GETLINECONTROLSF_ONEBYID查询类型结合使用。 请参阅 MIXERCONTROL 中的 dwControlType 成员说明。
cControls
要检索的 MIXERCONTROL 结构元素的数目。 在调用 mixerGetLineControls 函数之前，应用程序必须初始化此成员。 仅当指定了MIXER_GETLINECONTROLSF_ONEBYID或MIXER_GETLINECONTROLSF_ONEBYTYPE，或者在为音频线返回的 MIXERLINE 结构的 cControls 成员中返回的值时，此成员才能为 1。 此成员不能为零。 如果音频线指定它没有控件，则不应调用 mixerGetLineControls 。
cbmxctrl
单个 MIXERCONTROL 结构的大小（以字节为单位）。 此成员中指定的大小必须至少足以包含基本 MIXERCONTROL 结构。 pamxctrl 成员指向的缓冲区所需的总大小（以字节为单位）是 MIXERLINECONTROLS 结构的 cbmxctrl 和 cControls 成员的乘积。
pamxctrl
指向一个或多个 MIXERCONTROL 结构的指针，用于接收所请求的音频行控件的属性。 此成员不能为 NULL ，必须在调用 mixerGetLineControls 函数之前初始化。 控件数组的每个元素必须至少足够大，才能包含基本 MIXERCONTROL 结构。 cbmxctrl 成员必须指定此数组中每个元素的大小（以字节为单位）。 应用程序不需要对此成员指向的缓冲区进行初始化。 所有成员均由混音器设备填充， (包括成功返回后) 的每个 MIXERCONTROL 结构的 cbStruct 成员。
要求
| 最低受支持的客户端 | Windows 2000 Professional [仅限桌面应用] |
| 最低受支持的服务器 | Windows 2000 Server [仅限桌面应用] |
| 标头 | mmeapi.h |