Gestion des erreurs avec les fonctions audio

[La fonctionnalité associée à cette page, Waveform Audio, est une fonctionnalité héritée. Il a été remplacé par WASAPI et Audio Graphs. Les graphiques WASAPI et Audio ont été optimisés pour Windows 10 et Windows 11. Microsoft recommande vivement que le nouveau code utilise WASAPI et Audio Graphs au lieu de Waveform Audio, lorsque cela est possible. Microsoft suggère que le code existant qui utilise les API héritées soit réécrit pour utiliser les nouvelles API si possible.]

Les fonctions waveform-audio et auxiliaire-audio retournent une valeur différente de zéro lorsqu’une erreur se produit. Windows fournit des fonctions qui convertissent ces valeurs d’erreur en descriptions textuelles des erreurs. L’application doit toujours examiner les valeurs d’erreur pour déterminer comment procéder, mais les descriptions textuelles des erreurs peuvent être utilisées dans les boîtes de dialogue qui décrivent les erreurs pour les utilisateurs.

Vous pouvez utiliser les fonctions suivantes pour récupérer des descriptions textuelles des valeurs d’erreur audio :

Fonction	Description
waveInGetErrorText	Récupère une description textuelle d’une erreur d’entrée audio de forme d’onde spécifiée.
waveOutGetErrorText	Récupère une description textuelle d’une erreur de sortie audio de forme d’onde spécifiée.

 

Les seules fonctions audio qui ne retournent pas de valeurs d’erreur sont auxGetNumDevs, waveInGetNumDevs et waveOutGetNumDevs. Ces fonctions retournent zéro si aucun appareil n’est présent dans un système ou s’il rencontre des erreurs.