mixerGetControlDetails 函数 (mmeapi.h)
mixerGetControlDetails 函数检索有关与音频线关联的单个控件的详细信息。
语法
MMRESULT mixerGetControlDetails(
HMIXEROBJ hmxobj,
LPMIXERCONTROLDETAILS pmxcd,
DWORD fdwDetails
);
parameters
hmxobj
正在查询的 mixer 设备对象的句柄。
pmxcd
指向 MIXERCONTROLDETAILS 结构的指针，其中填充了有关控件的状态信息。
fdwDetails
用于检索控件详细信息的标志。 定义了以下值。
| 值 | 含义 |
|---|---|
| MIXER_GETCONTROLDETAILSF_LISTTEXT | MIXERCONTROLDETAILS 结构的 paDetails 成员指向一个或多个MIXERCONTROLDETAILS_LISTTEXT结构，以接收多项目控件的文本标签。 应用程序必须同时获取多项目控件的所有列表文本项。 此标志不能与MIXERCONTROL_CONTROLTYPE_CUSTOM控件一起使用。 |
| MIXER_GETCONTROLDETAILSF_VALUE | 检索控件的当前值。 MIXERCONTROLDETAILS 结构的 paDetails 成员指向适用于控件类的一个或多个详细信息结构。 |
| MIXER_OBJECTF_AUX | hmxobj 参数是一个辅助设备标识符，其范围为 0 到 1，小于 auxGetNumDevs 函数返回的设备数。 |
| MIXER_OBJECTF_HMIDIIN | hmxobj 参数是 MIDI (乐器数字接口) 输入设备的句柄。 此句柄必须由 midiInOpen 函数返回。 |
| MIXER_OBJECTF_HMIDIOUT | hmxobj 参数是 MIDI 输出设备的句柄。 此句柄必须由 midiOutOpen 函数返回。 |
| MIXER_OBJECTF_HMIXER | hmxobj 参数是由 mixerOpen 函数返回的 mixer 设备句柄。 此标志是可选的。 |
| MIXER_OBJECTF_HWAVEIN | hmxobj 参数是由 waveInOpen 函数返回的波形音频输入句柄。 |
| MIXER_OBJECTF_HWAVEOUT | hmxobj 参数是由 waveOutOpen 函数返回的波形音频输出句柄。 |
| MIXER_OBJECTF_MIDIIN | hmxobj 参数是 MIDI 输入设备的标识符。 此标识符的范围必须为 0 到 1，小于 midiInGetNumDevs 函数返回的设备数。 |
| MIXER_OBJECTF_MIDIOUT | hmxobj 参数是 MIDI 输出设备的标识符。 此标识符的范围必须为 0 到 1，小于 midiOutGetNumDevs 函数返回的设备数。 |
| MIXER_OBJECTF_MIXER | hmxobj 参数是混音器设备的标识符，其范围为 0 到 1，小于 mixerGetNumDevs 函数返回的设备数。 此标志是可选的。 |
| MIXER_OBJECTF_WAVEIN | hmxobj 参数是波形音频输入设备的标识符，其范围为 0 到 1，小于 waveInGetNumDevs 函数返回的设备数。 |
| MIXER_OBJECTF_WAVEOUT | hmxobj 参数是波形音频输出设备的标识符，其范围为 0 到比 waveOutGetNumDevs 函数返回的设备数少 1。 |
返回值
如果成功，则返回MMSYSERR_NOERROR，否则返回错误。 可能的错误值包括以下内容。
| 返回代码 | 说明 |
|---|---|
|
控件引用无效。 |
|
hmxobj 参数指定无效的设备标识符。 |
|
一个或多个标志无效。 |
|
hmxobj 参数指定无效句柄。 |
|
一个或多个参数无效。 |
|
hmxobj 指定的对象没有可用的混音器设备。 |
注解
在调用此函数之前，必须初始化 MIXERCONTROLDETAILS 结构的所有成员。
要求
| 最低受支持的客户端 | Windows 2000 Professional [仅限桌面应用] |
| 最低受支持的服务器 | Windows 2000 Server [仅限桌面应用] |
| 目标平台 | Windows |
| 标头 | mmeapi.h (包括 Mmeapi.h、Windows.h) |
| Library | Winmm.lib |
| DLL | Winmm.dll |