waveOutGetVolume 函式 (mmeapi.h)

waveOutGetVolume函式會擷取指定之電壓音訊輸出裝置的目前音量層級。

語法

MMRESULT waveOutGetVolume(
  HWAVEOUT hwo,
  LPDWORD  pdwVolume
);

hwo

處理開啟的電壓音訊輸出裝置。此參數也可以是裝置識別碼。

pdwVolume

要填入目前磁片區設定之變數的指標。這個位置的低序字包含左通道磁片區設定，而高階字則包含右通道設定。 0xFFFF的值代表完整磁片區，而0x0000的值則為無聲。

如果裝置不支援左右音量控制，則指定位置的低序字會包含 mono 音量層級。

不論裝置是否支援完整的 16 位控制，都會傳回使用 waveOutSetVolume 函式設定的完整 16 位設定 (s) 。

如果成功或發生錯誤，則傳回MMSYSERR_NOERROR。可能的錯誤值包括下列專案。

如果使用裝置識別碼， 則 waveOutGetVolume 呼叫的結果以及 pdwVolume 中傳回的資訊會套用至裝置的所有實例。如果使用裝置控制碼，則傳回的結果和資訊只適用于裝置控制碼所參考的裝置實例。

並非所有裝置都支援磁片區變更。若要判斷裝置是否支援磁片區控制，請使用 WAVECAPS_VOLUME 旗標來測試WAVEOUTCAPS結構的dwSupport成員 (由 waveOutGetDevCaps函式所填入) 。

若要判斷裝置是否支援左通道和右通道音量控制，請使用 WAVECAPS_LRVOLUME 旗標來測試WAVEOUTCAPS結構的dwSupport成員， (由 waveOutGetDevCaps) 填滿。

磁片區設定會以對數方式解譯。這表示當將磁片區層級從0x5000增加到0x6000時，察覺的磁片區增加與0x4000到0x5000相同。