變更Waveform-Audio播放的磁片區
[與此頁面相關聯的功能 「波狀音訊」是舊版功能。 WASAPI和音訊圖表已取代它。 WASAPI和音訊圖表已針對Windows 10和Windows 11進行優化。 Microsoft 強烈建議新程式碼盡可能使用 WASAPI 和 音訊圖形 ,而不是 「波形音訊」。 Microsoft 建議使用舊版 API 的現有程式碼盡可能重寫為使用新的 API。
Windows 提供下列函式來查詢及設定電壓音訊輸出裝置的音量層級。
函式 | 描述 |
---|---|
waveOutGetVolume | 擷取指定之電壓音訊輸出裝置的目前音量層級。 |
waveOutSetVolume | 設定指定之電壓音訊輸出裝置的音量層級。 |
並非所有的電壓音訊裝置都支援音量變更。 有些裝置支援左右通道上的個別磁片區控制。 如需如何判斷波音訊裝置音量控制功能的相關資訊,請參閱 裝置和資料類型。
有些應用程式可讓使用者控制系統中所有音訊裝置的音量。 (此類型的許多應用程式都使用音訊混音器服務;如需詳細資訊,請參閱 音訊混音器.) 除非您的應用程式能夠進行這種主要音量控制,否則您應該在變更其音量之前開啟音訊裝置。 您也應該在變更磁片區之前查詢磁片區層級,並儘快將磁片區層級還原至先前的層級。
磁片區是在雙字值中指定。 當音訊格式為立體時,上方 16 位會指定右通道的相對音量,而下方 16 位則指定左通道的相對音量。 對於不支援左通道和右通道音量控制的裝置,下方 16 位會指定磁片區層級,並忽略上方 16 位。
音量層級值的範圍從0x0 (無聲) 到0xFFFF (最大音量) ,並以對數方式解譯。 當將磁片區層級從0x5000增加到0x6000時,感知的磁片區增加與0x4000到0x5000相同。