Fonction AMGetErrorTextA (errors.h)

  • Article

[La fonctionnalité associée à cette page, DirectShow, est une fonctionnalité héritée. Il a été remplacé par MediaPlayer, IMFMediaEngine et Audio/Video Capture in 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 Audio/Video Capture dans Media Foundation au lieu de DirectShow, si 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 pour un code de retour donné, à l’aide du paramètre de langue actuel.

Cette fonction convertit les codes de retour HRESULT 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 retournée

Retourne le nombre de caractères retournés dans la mémoire tampon, ou zéro si une erreur s’est produite.

Remarques

Notes

L’en-tête errors.h définit AMGetErrorText en tant qu’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. La combinaison 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.

Configuration requise

Condition requise Valeur
Plateforme cible Windows
En-tête errors.h
Bibliothèque Quartz.lib

Voir aussi

Fonctions