變更 Waveform-Audio 播放的音量

與此頁面相關聯的功能，波形音訊，是舊版功能。 WASAPI 和 Audio Graphs已取代它。 WASAPI 和 音訊圖形 已針對 Windows 10 和 Windows 11 優化。 Microsoft強烈建議新程式代碼盡可能使用 WASAPI 和 Audio Graphs，而不是 波波音頻。 Microsoft建議使用舊版 API 的現有程式代碼，盡可能改寫成使用新的 API。]

Windows 提供下列功能來查詢和設定電壓音訊輸出裝置的音量層級。

功能	描述
waveOutGetVolume	擷取指定之超聲波音頻輸出裝置目前的音量層級。
waveOutSetVolume	設定指定之超聲波音頻輸出裝置的音量層級。

 

並非所有超聲波音頻裝置都支援音量變更。 某些裝置支持左右聲道上的個別音量控制。 如需如何判斷超聲波音頻裝置音量控制功能的相關信息，請參閱 裝置和數據類型。

某些應用程式可讓使用者控制系統中所有音訊裝置的音量。 （此類型的許多應用程式都使用音訊混音器服務;如需詳細資訊，請參閱 音訊混音器。除非您的應用程式能夠進行這種主要音量控制，否則您應該先開啟音訊裝置，再變更其音量。 您也應該在變更磁碟區層級之前查詢磁碟區層級，並儘快將磁碟區層級還原到其先前的層級。

容量以雙字值指定。 當音訊格式為立體聲時，上方 16 位會指定右通道的相對音量，而下方 16 位則指定左通道的相對音量。 對於不支援左右通道音量控制的裝置，下層 16 位會指定音量層級，並忽略前 16 位。

磁碟區層級值的範圍從0x0（無聲）到0xFFFF（最大音量），並以對數方式解譯。 當將音量從0x5000增加到0x6000時，感知的音量增加與從0x4000增加到0x5000時相同。