Fonction IddCxReportCriticalError (iddcx.h)
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 |