共用方式為


處理音訊函式的錯誤

[與此頁面相關聯的功能 「波狀音訊」是舊版功能。 WASAPI音訊圖表已取代它。 WASAPI音訊圖表已針對Windows 10和Windows 11進行優化。 Microsoft 強烈建議新程式碼盡可能使用 WASAPI音訊圖形 ,而不是 「波形音訊」。 Microsoft 建議使用舊版 API 的現有程式碼盡可能重寫為使用新的 API。

當發生錯誤時,電壓音訊和輔助音訊函式會傳回非零值。 Windows 提供將這些錯誤值轉換成錯誤文字描述的函式。 應用程式仍必須檢查錯誤值,以判斷如何繼續,但錯誤文字描述可用於描述使用者錯誤的對話方塊中。

您可以使用下列函式來擷取音訊錯誤值的文字描述:

函式 描述
waveInGetErrorText 擷取指定之電壓音訊輸入錯誤的文字描述。
waveOutGetErrorText 擷取指定之電壓音訊輸出錯誤的文字描述。

 

未傳回錯誤值的唯一音訊函式是 auxGetNumDevswaveInGetNumDevswaveOutGetNumDevs。 如果系統中沒有裝置或遇到任何錯誤,這些函式會傳回零。