MIXERLINECONTROLSA 结构（mmeapi.h）

项目
11/20/2024

MIXERLINECONTROLS 结构包含有关音频线控件的信息。

语法

typedef struct tagMIXERLINECONTROLSA {
  DWORD           cbStruct;
  DWORD           dwLineID;
  union {
    DWORD dwControlID;
    DWORD dwControlType;
  } DUMMYUNIONNAME;
  DWORD           cControls;
  DWORD           cbmxctrl;
  LPMIXERCONTROLA pamxctrl;
} MIXERLINECONTROLSA, *PMIXERLINECONTROLSA, *LPMIXERLINECONTROLSA;

成员

cbStruct

MIXERLINECONTROLS 结构的大小（以字节为单位）。在调用 mixerGetLineControls 函数之前，必须先初始化此成员。此成员中指定的大小必须足够大，才能包含 MIXERLINECONTROLS 结构。当 mixerGetLineControls 返回时，此成员包含返回的信息的实际大小。返回的信息不会超过请求的大小，也不会小于 MIXERLINECONTROLS 结构。

dwLineID

要查询控件的行标识符。如果为 mixerGetLineControls 函数指定了MIXER_GETLINECONTROLSF_ONEBYID标志，则不会使用此成员，但混音器设备在本例中仍返回此成员。指定MIXER_GETLINECONTROLSF_ALL时，不使用 dwControlID 和 dwControlType 成员。

DUMMYUNIONNAME

DUMMYUNIONNAME.dwControlID

所需控件的控件标识符。此成员与 mixerGetLineControls 函数的MIXER_GETLINECONTROLSF_ONEBYID标志一起使用，以检索指定控件的控件信息。请注意，dwLineIDMIXERLINECONTROLS 结构的成员将由混音器设备返回，不需要作为输入参数。此成员与 dwControlType 成员重叠，不能与MIXER_GETLINECONTROLSF_ONEBYTYPE查询类型结合使用。

DUMMYUNIONNAME.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 结构的大小（以字节为单位）。此成员中指定的大小必须至少足够大，才能包含 base MIXERCONTROL 结构。 pamxctrl 成员指向的缓冲区的总大小（以字节为单位）是 cbmxctrl 的乘积，cControlsMIXERLINECONTROLS 结构的成员。

pamxctrl

指向一个或多个 MIXERCONTROL 结构的指针，用于接收请求的音频线路控件的属性。此成员不能 NULL，必须在调用 mixerGetLineControls 函数之前进行初始化。控件数组的每个元素必须至少足够大，才能包含基本 MIXERCONTROL 结构。 cbmxctrl 成员必须指定此数组中每个元素的大小（以字节为单位）。应用程序不需要此成员指向的缓冲区初始化。成功返回后，所有成员都由混音器设备填充（包括每个 MIXERCONTROL 结构的 cbStruct 成员）。

言论

注意

mmeapi.h 标头将 MIXERLINECONTROLS 定义为一个别名，该别名根据 UNICODE 预处理器常量的定义自动选择此函数的 ANSI 或 Unicode 版本。将中性编码别名与不中性编码的代码混合使用可能会导致编译或运行时错误不匹配。有关详细信息，请参阅函数原型的约定。

要求

要求	价值
最低支持的客户端	Windows 2000 Professional [仅限桌面应用]
支持的最低服务器	Windows 2000 Server [仅限桌面应用]
标头	mmeapi.h