Behandeln von Fehlern mit Audiofunktionen
[Das dieser Seite zugeordnete Feature Waveform Audio ist ein Legacyfeature. Es wurde von WASAPI und Audio Graphs abgelöst. WASAPI- und Audiographen wurden für Windows 10 und Windows 11 optimiert. Microsoft empfiehlt dringend, dass neuer Code nach Möglichkeit WASAPI - und Audiographen anstelle von Waveform Audio verwenden sollte. Microsoft schlägt vor, dass vorhandener Code, der die Legacy-APIs verwendet, so umgeschrieben wird, dass nach Möglichkeit die neuen APIs verwendet werden.]
Die Funktionen waveform-audio und auxiliary-audio geben einen Wert ungleich 0 (null) zurück, wenn ein Fehler auftritt. Windows stellt Funktionen bereit, die diese Fehlerwerte in Textbeschreibungen der Fehler konvertieren. Die Anwendung muss weiterhin die Fehlerwerte untersuchen, um zu bestimmen, wie fortzufahren ist, aber Textbeschreibungen von Fehlern können in Dialogfeldern verwendet werden, in denen Fehler für Benutzer beschrieben werden.
Sie können die folgenden Funktionen verwenden, um Textbeschreibungen von Audiofehlerwerten abzurufen:
| Funktion | BESCHREIBUNG |
|---|---|
| waveInGetErrorText | Ruft eine Textbeschreibung eines angegebenen Waveform-Audioeingabefehlers ab. |
| waveOutGetErrorText | Ruft eine Textbeschreibung eines angegebenen Wellenform-Audioausgabefehlers ab. |
Die einzigen Audiofunktionen, die keine Fehlerwerte zurückgeben, sind auxGetNumDevs, waveInGetNumDevs und waveOutGetNumDevs. Diese Funktionen geben null zurück, wenn keine Geräte in einem System vorhanden sind oder Fehler auftreten.