auxGetVolume 函式 (mmeapi.h)
auxGetVolume 函式會擷取指定輔助輸出裝置的目前磁碟區設定。
語法
MMRESULT auxGetVolume(
UINT uDeviceID,
LPDWORD pdwVolume
);
參數
uDeviceID
要查詢之輔助輸出裝置的識別碼。
pdwVolume
要填入目前磁碟區設定之變數的指標。 這個位置的低序字組包含左通道音量設定，而高序字組則包含右通道設定。 0xFFFF 的值代表完整磁碟區，而0x0000的值則為無聲。
如果裝置不支援左右音量控制，則指定位置的低序字組會包含磁碟區層級。
不論裝置是否支援完整的16位控制，都會傳回使用 auxSetVolume 函式設定的完整16位設定 () 。
傳回值
如果成功或發生錯誤，則傳回MMSYSERR_NOERROR。 可能的錯誤值包括下列專案。
| 傳回碼 | Description |
|---|---|
|
指定的裝置識別碼超出範圍。 |
備註
並非所有裝置都支援磁碟區控制。 若要判斷裝置是否支援音量控制，請使用 AUXCAPS_VOLUME 旗標來測試由 auxGetDevCaps 函式所填入 (之 AUXCAPS 結構的 dwSupport 成員) 。
若要判斷裝置是否支援左右通道上的音量控制，請使用 AUXCAPS_LRVOLUME 旗標來測試由 auxGetDevCaps) 填滿之 AUXCAPS (結構的 dwSupport 成員。
規格需求
| 需求 | 值 |
|---|---|
| 最低支援的用戶端 | Windows 2000 Professional [僅限傳統型應用程式] |
| 最低支援的伺服器 | Windows 2000 Server [僅限桌面應用程式] |
| 目標平台 | Windows |
| 標頭 | mmeapi.h (包含 Windows.h) |
| 程式庫 | Winmm.lib |
| Dll | Winmm.dll |