通过

mixerGetControlDetailsW 函数 （mmeapi.h）

  • 项目

mixerGetControlDetails 函数检索与音频行关联的单个控件的详细信息。

语法

MMRESULT mixerGetControlDetailsW(
  HMIXEROBJ             hmxobj,
  LPMIXERCONTROLDETAILS pmxcd,
  DWORD                 fdwDetails
);

参数

hmxobj

正在查询的混音器设备对象的句柄。

pmxcd

指向 MIXERCONTROLDETAILS 结构的指针，该结构充满了有关控件的状态信息。

fdwDetails

用于检索控件详细信息的标志。 定义了以下值。

价值 意义
MIXER_GETCONTROLDETAILSF_LISTTEXT paDetailsMIXERCONTROLDETAILS 结构的成员指向一个或多个 MIXERCONTROLDETAILS_LISTTEXT 结构，以接收多项控件的文本标签。 应用程序必须同时获取多项控件的所有列表文本项。 此标志不能与MIXERCONTROL_CONTROLTYPE_CUSTOM控件一起使用。
MIXER_GETCONTROLDETAILSF_VALUE 检索控件的当前值。 paDetailsMIXERCONTROLDETAILS 结构的成员指向适用于控件类的一个或多个详细信息结构。
MIXER_OBJECTF_AUX hmxobj 参数是零到一个小于 auxGetNumDevs 函数返回的设备数的辅助设备标识符。
MIXER_OBJECTF_HMIDIIN hmxobj 参数是 MIDI（乐器数字接口）输入设备的句柄。 此句柄必须由 midiInOpen 函数返回。
MIXER_OBJECTF_HMIDIOUT hmxobj 参数是 MIDI 输出设备的句柄。 此句柄必须由 midiOutOpen 函数返回。
MIXER_OBJECTF_HMIXER hmxobj 参数是由 mixerOpen 函数返回的混音器设备句柄。 此标志是可选的。
MIXER_OBJECTF_HWAVEIN hmxobj 参数是由 waveInOpen 函数返回的波形音频输入句柄。
MIXER_OBJECTF_HWAVEOUT hmxobj 参数是由 waveOutOpen 函数返回的波形音频输出句柄。
MIXER_OBJECTF_MIDIIN hmxobj 参数是 MIDI 输入设备的标识符。 此标识符的范围必须小于 midiInGetNumDevs 函数返回的设备数。
MIXER_OBJECTF_MIDIOUT hmxobj 参数是 MIDI 输出设备的标识符。 此标识符的范围必须小于 midiOutGetNumDevs 函数返回的设备数。
MIXER_OBJECTF_MIXER hmxobj 参数是混音器设备的标识符，其范围为 0 到 1，小于 mixerGetNumDevs 函数返回的设备数。 此标志是可选的。
MIXER_OBJECTF_WAVEIN hmxobj 参数是波形音频输入设备的标识符，其范围为零到一个小于 waveInGetNumDevs 函数返回的设备数。
MIXER_OBJECTF_WAVEOUT hmxobj 参数是波形音频输出设备的标识符，其范围为零到一个小于 waveOutGetNumDevs 函数返回的设备数。

返回值

如果成功或错误，则返回MMSYSERR_NOERROR。 可能的错误值包括以下内容。

返回代码 描述
MIXERR_INVALCONTROL
 控件引用无效。
MMSYSERR_BADDEVICEID
 hmxobj 参数指定了无效的设备标识符。
MMSYSERR_INVALFLAG
 一个或多个标志无效。
MMSYSERR_INVALHANDLE
 hmxobj 参数指定无效句柄。
MMSYSERR_INVALPARAM
 一个或多个参数无效。
MMSYSERR_NODRIVER
 hmxobj指定的对象没有混音器设备。

言论

在调用此函数之前，必须先初始化 MIXERCONTROLDETAILS 结构的所有成员。

注意

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

要求

要求 价值
最低支持的客户端 Windows 2000 Professional [仅限桌面应用]
支持的最低服务器 Windows 2000 Server [仅限桌面应用]
目标平台 窗户
标头 mmeapi.h （包括 Mmeapi.h、Windows.h）
库 Winmm.lib
DLL Winmm.dll

另请参阅

音频混音器函数

音频混音器