auxGetVolume 函数 (mmeapi.h)
auxGetVolume 函数检索指定辅助输出设备的当前音量设置。
语法
MMRESULT auxGetVolume(
UINT uDeviceID,
LPDWORD pdwVolume
);
参数
uDeviceID
要查询的辅助输出设备的标识符。
pdwVolume
指向要用当前音量设置填充的变量的指针。 此位置的低序字包含左声道音量设置，高位字包含右声道设置。 值 0xFFFF 表示完整音量，值 0x0000 表示静音。
如果设备不支持左右音量控制，则指定位置的低序字将包含音量级别。
无论设备是否支持完整的 16 位音量级别控制，都会返回使用 auxSetVolume 函数设置 (s) 设置的完整 16 位设置。
返回值
如果成功，则返回MMSYSERR_NOERROR，否则返回错误。 可能的错误值包括以下内容。
| 返回代码 | 说明 |
|---|---|
|
指定的设备标识符在范围外。 |
注解
并非所有设备都支持音量控制。 若要确定设备是否支持音量控制，请使用 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 |