通过

mixerGetID 函数 (mmeapi.h)

  • 项目

mixerGetID 函数检索与指定设备句柄关联的混音器设备的设备标识符。

语法

MMRESULT mixerGetID(
  HMIXEROBJ hmxobj,
  UINT      *puMxId,
  DWORD     fdwId
);

参数

hmxobj

要映射到混音器设备标识符的混音器对象的句柄。

puMxId

指向接收混音器设备标识符的变量的指针。 如果没有可用于 hmxobj 对象的混音器设备，则值 -1 将放置在此位置，并返回MMSYSERR_NODRIVER错误值。

fdwId

用于映射 mixer 对象 hmxobj 的标志。 定义了以下值。

值 含义
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，否则返回错误。 可能的错误值包括以下内容。

返回代码 说明
MMSYSERR_BADDEVICEID
 hmxobj 参数指定无效的设备标识符。
MMSYSERR_INVALFLAG
 一个或多个标志无效。
MMSYSERR_INVALHANDLE
 hmxobj 参数指定无效句柄。
MMSYSERR_INVALPARAM
 一个或多个参数无效。
MMSYSERR_NODRIVER
 没有音频混音器设备可用于 hmxobj 指定的对象。 puMxId 引用的位置还包含值 -1。

要求

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

另请参阅

音频混音器函数

音频混音器