共用方式為


處理音訊函式的錯誤

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

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

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

功能 描述
waveInGetErrorText 取得指定波形音訊輸入錯誤的文字描述。
waveOutGetErrorText 擷取指定之超聲波音頻輸出錯誤的文字描述。

 

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