auxGetVolume 函数 (mmeapi.h)

auxGetVolume 函数检索指定辅助输出设备的当前音量设置。

语法

MMRESULT auxGetVolume(
  UINT    uDeviceID,
  LPDWORD pdwVolume
);

uDeviceID

要查询的辅助输出设备的标识符。

pdwVolume

指向要用当前音量设置填充的变量的指针。此位置的低序字包含左声道音量设置，高位字包含右声道设置。值 0xFFFF 表示完整音量，值 0x0000 表示静音。

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

无论设备是否支持完整的 16 位音量级别控制，都会返回使用 auxSetVolume 函数设置 (s) 设置的完整 16 位设置。

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

返回代码	说明
MMSYSERR_BADDEVICEID	指定的设备标识符在范围外。

并非所有设备都支持音量控制。若要确定设备是否支持音量控制，请使用 AUXCAPS_VOLUME 标志测试由 auxGetDevCaps 函数) 填充的 AUXCAPS 结构的 dwSupport 成员 (。

若要确定设备是否支持左右通道上的音量控制，请使用 AUXCAPS_LRVOLUME 标志测试 AUXCAPS 结构的 dwSupport 成员， (由 auxGetDevCaps) 填充。

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