AMGetErrorTextA, fonction (errors.h)
[La fonctionnalité associée à cette page, DirectShow, est une fonctionnalité héritée. Il a été remplacé par MediaPlayer, IMFMediaEngineet audio/vidéo capture dans Media Foundation. Ces fonctionnalités ont été optimisées pour Windows 10 et Windows 11. Microsoft recommande vivement que le nouveau code utilise MediaPlayer, IMFMediaEngine et capture audio/vidéo dans Media Foundation au lieu de directShow, 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.]
La fonction AMGetErrorText récupère le message d’erreur d’un code de retour donné à l’aide du paramètre de langue actuel.
Cette fonction convertit HRESULT codes de retour en messages d’erreur. La constante MAX_ERROR_TEXT_LEN spécifie le nombre maximal de caractères dans un message d’erreur.
Syntaxe
AMOVIEAPI DWORD AMGetErrorTextA(
HRESULT hr,
LPSTR pbuffer,
DWORD MaxLen
);
Paramètres
hr
valeur HRESULT.
pbuffer
Pointeur vers une mémoire tampon de caractères qui reçoit le message d’erreur.
MaxLen
Nombre de caractères dans pBuffer .
Valeur de retour
Retourne le nombre de caractères retournés dans la mémoire tampon, ou zéro si une erreur s’est produite.
Remarques
Note
L’en-tête errors.h définit AMGetErrorText comme alias qui sélectionne automatiquement la version ANSI ou Unicode de cette fonction en fonction de la définition de la constante de préprocesseur UNICODE. Le mélange de l’utilisation de l’alias neutre en encodage avec du code qui n’est pas neutre en encodage peut entraîner des incompatibilités qui entraînent des erreurs de compilation ou d’exécution. Pour plus d’informations, consultez Conventions pour les prototypes de fonction.
Exigences
| Exigence | Valeur |
|---|---|
| plateforme cible | Windows |
| d’en-tête | errors.h |
| bibliothèque | Quartz.lib |