MIXERLINECONTROLSA 结构 (mmeapi.h)

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时,不使用 dwControlIDdwControlType 成员。

DUMMYUNIONNAME

DUMMYUNIONNAME.dwControlID

所需控件的控件标识符。 此成员与 mixerGetLineControls 函数的 MIXER_GETLINECONTROLSF_ONEBYID 标志一起使用,以检索指定控件的控件信息。 请注意,MIXERLINECONTROLS 结构的 dwLineID 成员将由混音器设备返回,不需要作为输入参数。 此成员与 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 结构的大小(以字节为单位)。 此成员中指定的大小必须至少足够大,才能包含基本 MIXERCONTROL 结构。 pamxctrl 成员指向的缓冲区所需的总大小(以字节为单位)是 MIXERLINECONTROLS 结构的 cbmxctrlcControls 成员的乘积。

pamxctrl

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

注解

注意

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

要求

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

另请参阅

音频混音器结构

音频混音器

MIXERCONTROL

MIXERLINE

mixerGetLineControls