midiOutGetVolume 函数 (mmeapi.h)

midiOutGetVolume 函数检索 MIDI 输出设备的当前卷设置。

语法

MMRESULT midiOutGetVolume(
  HMIDIOUT hmo,
  LPDWORD  pdwVolume
);

参数

hmo

打开的 MIDI 输出设备的句柄。 此参数还可以包含 MIDI 流的句柄,只要它被强制转换为 HMIDIOUT 即可。 此参数也可以是设备标识符。

pdwVolume

指向包含当前卷设置的位置的指针。 此位置的低序字包含左声道音量设置,高序字包含右声道设置。 值 0xFFFF 表示完整音量,0x0000 值为静音。

如果设备不支持左右音量控制,则指定位置的低序字包含单声道音量级别。

无论设备是否支持该值,都会返回使用 midiOutSetVolume 函数设置的任何值。

返回值

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

返回代码 说明
MMSYSERR_INVALHANDLE
指定的设备句柄无效。
MMSYSERR_INVALPARAM
指定的指针或结构无效。
MMSYSERR_NOMEM
系统无法分配或锁定内存。
MMSYSERR_NOTSUPPORTED
不支持 函数。

注解

如果使用设备标识符,则 midiOutGetVolume 调用的结果以及 lpdwVolume 中返回的信息将应用于设备的所有实例。 如果使用设备句柄,则返回的结果和信息仅适用于设备句柄引用的设备实例。

并非所有设备都支持音量控制。 通过使用 midiOutGetDevCaps 函数并指定MIDICAPS_VOLUME标志来查询设备,可以确定设备是否支持音量控制。

还可以通过使用 midiOutGetDevCaps 函数查询设备并指定MIDICAPS_LRVOLUME标志,来确定设备是否支持左右通道的音量控制。

要求

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

另请参阅

MIDI 函数