Partager via


IAMErrorLog::LogError, méthode

[La fonctionnalité associée à cette page, DirectShow, est une fonctionnalité héritée. Il a été remplacé par MediaPlayer, IMFMediaEngine et Audio/Video Capture dans Media Foundation. Ces fonctionnalités ont été optimisées pour Windows 10 et Windows 11. Microsoft recommande vivement au nouveau code d’utiliser MediaPlayer, IMFMediaEngine et La 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.]

Notes

[Déconseillé. Cette API peut être supprimée des versions ultérieures de Windows.]

 

La méthode LogError consigne une erreur. Les applications n’ont pas besoin d’appeler cette méthode. Il est appelé en interne en réponse aux erreurs de rendu.

Syntaxe

HRESULT LogError(
       LONG    Severity,
       BSTR    ErrorString,
       LONG    ErrorCode,
       HRESULT hresult,
  [in] VARIANT *pExtraInfo
);

Paramètres

Niveau de gravité

Réservé. Ne pas utiliser.

ErrorString

Valeur de chaîne contenant le texte de l’erreur.

ErrorCode

Code d’erreur.

Hresult

Valeur HRESULT retournée par l’appel de méthode à l’origine de l’erreur.

pExtraInfo [in]

Pointeur vers un VARIANT qui contient des informations supplémentaires sur l’erreur.

Valeur renvoyée

Retourne la valeur du paramètre hresult .

Notes

Dans cette méthode, ne libérez pas le VARIANT pointé vers pExtraInfo. En outre, le VARIANT devient non valide une fois que la méthode est retournée. N’essayez donc pas de la référencer ultérieurement.

Implémentez cette méthode pour retourner aussi rapidement que possible. N’effectuez pas d’appels de fonction à partir de cette méthode susceptible de bloquer l’exécution du programme. Par exemple, n’appelez pas les fonctions qui envoient des messages de fenêtre, bloquent les événements ou qui, dans le cas contraire, peuvent bloquer l’exécution. Cela peut entraîner l’arrêt de la réponse de l’ordinateur.

Pour obtenir la liste des erreurs définies par DES, ainsi que la signification et le type de données du VARIANT pointé vers pExtraInfo, consultez Erreurs de rendu.

Remarque

Le fichier d’en-tête Qedit.h n’est pas compatible avec les en-têtes Direct3D ultérieurs à la version 7.

 

Notes

Pour obtenir Qedit.h, téléchargez la mise à jour Microsoft Windows SDK pour Windows Vista et .NET Framework 3.0. Qedit.h n’est pas disponible dans le Microsoft Windows SDK pour Windows 7 et .NET Framework 3.5 Service Pack 1.

 

Configuration requise

Condition requise Valeur
En-tête
Qedit.h
Bibliothèque
Strmiids.lib

Voir aussi

IAMErrorLog Interface

Codes d’erreur et de réussite