Menangani Kesalahan dengan Fungsi Audio

[Fitur yang terkait dengan halaman ini, Waveform Audio, adalah fitur warisan. Ini telah digantikan oleh WASAPI dan Audio Graphs. WASAPI dan Audio Graphs telah dioptimalkan untuk Windows 10 dan Windows 11. Microsoft sangat menyarankan agar kode baru menggunakan WASAPI dan Audio Graphs alih-alih Waveform Audio, jika memungkinkan. Microsoft menyarankan agar kode yang ada yang menggunakan API warisan ditulis ulang untuk menggunakan API baru jika memungkinkan.]

Fungsi waveform-audio dan auxiliary-audio mengembalikan nilai bukan nol saat terjadi kesalahan. Windows menyediakan fungsi yang mengonversi nilai kesalahan ini menjadi deskripsi tekstual kesalahan. Aplikasi masih harus memeriksa nilai kesalahan untuk menentukan cara melanjutkan, tetapi deskripsi tekstual kesalahan dapat digunakan dalam kotak dialog yang menjelaskan kesalahan kepada pengguna.

Anda dapat menggunakan fungsi berikut untuk mengambil deskripsi tekstual nilai kesalahan audio:

Fungsi	Deskripsi
waveInGetErrorText	Mengambil deskripsi tekstual dari kesalahan input waveform-audio tertentu.
waveOutGetErrorText	Mengambil deskripsi tekstual dari kesalahan output waveform-audio tertentu.

 

Satu-satunya fungsi audio yang tidak mengembalikan nilai kesalahan adalah auxGetNumDevs, waveInGetNumDevs, dan waveOutGetNumDevs. Fungsi-fungsi ini mengembalikan nol jika tidak ada perangkat yang ada dalam sistem atau jika mengalami kesalahan.