mixerSetControlDetails 函数 (mmeapi.h)

mixerSetControlDetails 函数设置与音频线关联的单个控件的属性。

语法

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

参数

hmxobj

要为其设置属性的 mixer 设备对象的句柄。

pmxcd

指向 MIXERCONTROLDETAILS 结构的指针。 此结构用于引用包含控件所需状态的控件详细信息结构。

fdwDetails

用于设置控件属性的标志。 定义了以下值。

含义
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。
MIXER_SETCONTROLDETAILSF_CUSTOM 将显示指定的自定义混音器控件的自定义对话框。 混音器设备从用户收集所需的信息,并在指定的缓冲区中返回数据。 拥有窗口的句柄在 MIXERCONTROLDETAILS 结构的 hwndOwner 成员中指定。 (此句柄可以设置为 NULL。) 应用程序随后可以从对话框中保存数据,并在以后使用 MIXER_SETCONTROLDETAILSF_VALUE 标志将控件重置为相同状态。
MIXER_SETCONTROLDETAILSF_VALUE 设置控件的当前值 () 。 MIXERCONTROLDETAILS 结构的 paDetails 成员指向控件的相应类的一个或多个 mixer-control 详细信息结构。

返回值

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

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

注解

在调用 mixerSetControlDetails 之前,必须初始化 MIXERCONTROLDETAILS 结构的所有成员。

如果应用程序只需检索自定义混音器控件的当前状态而不显示对话框,则可以将 mixerGetControlDetails 与 MIXER_GETCONTROLDETAILSF_VALUE 标志一起使用。

要求

要求
最低受支持的客户端 Windows 2000 Professional [仅限桌面应用]
最低受支持的服务器 Windows 2000 Server [仅限桌面应用]
目标平台 Windows
标头 mmeapi.h (包括 Windows.h)
Library Winmm.lib
DLL Winmm.dll

另请参阅

音频混音器函数

音频混音器