Vue d’ensemble du débogage NDIS

Les deux principaux outils pour le débogage d’un pilote réseau sont le suivi de débogage et les extensions NDIS (Network Driver Interface Specification). Pour plus d’informations sur le suivi de débogage, consultez Activation du suivi de débogage NDIS. Pour plus d’informations sur les extensions de débogage NDIS, consultez Extensions NDIS, qui fournit une liste complète des commandes d’extension trouvées dans le module d’extension Ndiskd.dll.

Utilisez la commande ndiskd.netreport pour générer un rapport visuel montrant les adaptateurs et les protocoles actuels.

Ensuite, la commande de débogueur du noyau ndiskd.netadapter est un bon endroit pour commencer à examiner l’ensemble actuel des pilotes.

1: kd> !ndiskd.netadapter
    Driver             NetAdapter          Name
    ffffdf8015a98380   ffffdf8015aa11a0    Microsoft ISATAP Adapter #2
    ffffdf801418d650   ffffdf80140c71a0    Microsoft Kernel Debug Network Adapter

Un outil supplémentaire pour le débogage d’un pilote réseau est la collection d’extensions de débogage régulières, qui sont utiles pour obtenir des informations de débogage. Par exemple, la saisie de !stacks 2 ndis ! affiche tous les threads de la pile commençant par ndis !. Ces informations peuvent être utiles pour le débogage des blocages et des blocages. Pour obtenir des informations générales sur la prise en main de WinDbg, consultez Prise en main du débogage Windows.

Driver Verifier

Un autre outil utile pour tester un pilote NDIS est le vérificateur NDIS. Pour plus d’informations, consultez Règles pour les pilotes NDIS et le vérificateur de pilotes statiques.

Ressources de débogage NDIS

L’épisode 175 de l’émission Outils de défragmentation couvre le débogage NDIS - Outils de défragmentation #175 - Débogage de la pile réseau.

Les archives du blog de l’équipe NDIS sont disponibles sur le blog NDIS.

Vérifications des bogues NDIS

Il existe également un code de case activée de bogue spécifique à NDIS, case activée 0x7C de bogues (BUGCODE_NDIS_DRIVER). Pour obtenir la liste complète de ses paramètres, consultez Vérification des bogues 0x7C.

Une erreur de comportement NDIS courante case activée de bogue est la vérification des bogues 0xD1 : DRIVER_IRQL_NOT_LESS_OR_EQUAL qui peut être causée par le code du pilote lui-même. Il s’agit probablement d’un bogue ou d’une altération de la mémoire qui finit par se manifester par un mauvais pointeur.

Un autre problème courant est la vérification des bogues 0x9F : DRIVER_POWER_STATE_FAILURE.

La première étape de toutes les vérifications de bogues consiste à localiser un fichier de vidage correct, à le charger dans le débogueur Windows et à utiliser la commande !analyze . Pour plus d’informations, consultez Utilisation de l’extension !analyze.