Fonction IddCxReportCriticalError (iddcx.h)

  • Article

IddCxReportCriticalError est une fonction de rappel du système d’exploitation appelée par un pilote d’affichage indirect (IDD) pour signaler une erreur critique.

Syntaxe

NTSTATUS IddCxReportCriticalError(
  IDDCX_ADAPTER                      AdapterObject,
  const IDARG_IN_REPORTCRITICALERROR *pInArgs
);

Paramètres

AdapterObject

Objet IDDCX_ADAPTER de l’adaptateur sur lequel l’erreur critique s’est produite. Si l’erreur s’est produite avant la création d’un IDDCX_ADAPTER, l’IDD doit passer nullptr.

pInArgs

Pointeur vers une structure de IDARG_IN_REPORTCRITICALERROR contenant le code d’erreur de l’erreur critique.

Valeur retournée

Si la routine réussit, elle ne revient jamais au pilote, car le processus du pilote est terminé.

Remarques

Lorsqu’un IDD appelle IddCxCriticalError, le système d’exploitation effectue les opérations suivantes :

  • Vérifiez les bogues du pilote avec le code de vérification des bogues suivant : (pInArgs->MajorErrorCode+0x100 << 8) + pInArgs->MinorErrorCode. Il est recommandé que le pilote utilise une combinaison unique d’un code principal et d’un code mineur afin que ces cas puissent être identifiés dans les incidents et les rapports Watson.
  • Arrêtez le processus du pilote et redémarrez selon la stratégie de redémarrage du pilote UMDF.
  • Si l’appelant est un IDD distant, déconnectez la session utilisateur.

Lorsqu’un vidage de mémoire en mode utilisateur est généré, le pilote doit placer toutes les informations de débogage utiles sur la pile de la fonction appelée IddCxCriticalError.

Configuration requise

Condition requise Valeur
Client minimal pris en charge Windows 10
En-tête iddcx.h

Voir aussi

IDARG_IN_REPORTCRITICALERROR