Introduction aux routines de pilotes standard
Chaque pilote en mode noyau est construit autour d’un ensemble de routines de pilotes standard définies par le système. Les pilotes en mode noyau traitent les paquets de demandes d’E/ S (IRP) au sein de ces routines standard en appelant des routines de prise en charge des pilotes fournis par le système.
Tous les conducteurs, quel que soit leur niveau dans une chaîne de conducteurs attachés, doivent avoir un ensemble de routines standard de base pour traiter les IRP. Le fait qu’un pilote doit implémenter des routines standard supplémentaires dépend du fait qu’il contrôle un périphérique physique ou s’il est superposé à un pilote de périphérique physique, ainsi que de la nature de l’appareil physique sous-jacent. Les pilotes de niveau inférieur qui contrôlent les périphériques physiques ont plus de routines requises que les pilotes de niveau supérieur, qui passent généralement des IRP à un pilote inférieur pour traitement.
Les routines de pilotes standard peuvent être divisées en deux groupes : celles que chaque pilote en mode noyau doit avoir et celles qui sont facultatives, en fonction du type de pilote et de l’emplacement dans la pile de périphériques.
Le tableau suivant répertorie les routines standard requises.
| Routines de pilotes standard requises | Objectif | Où décrit |
|---|---|---|
| DriverEntry | Initialise le pilote et son objet driver. | Écriture d’une routine DriverEntry |
| AddDevice | Initialise des appareils et crée des objets d’appareil. | Écriture d’une routine AddDevice |
| Routines de distribution | Recevoir et traiter des IRP. | Écriture de routines de répartition |
| Décharger | Libérer les ressources système acquises par le pilote. | Écriture d’une routine de déchargement |
Le tableau suivant répertorie plusieurs routines facultatives.
| Routines de pilotes standard facultatives | Objectif | Où décrit |
|---|---|---|
| Réinitialiser | Termine l’initialisation du pilote si DriverEntry ne peut pas. | Écriture d’une routine de réinitialisation |
| StartIo | Démarre une opération d’E/S sur un appareil physique. | Écriture d’une routine StartIo |
| Routine du service d’interruption | Enregistre l’état d’un appareil lorsqu’il s’interrompt. | Écriture d’un ISR |
| Appels de procédure différée | Termine le traitement d’une interruption d’appareil après qu’un ISR a enregistré l’état de l’appareil. | Objets DPC et DPC |
| SynchCritSection | Synchronise l’accès aux données du pilote. | Utilisation des sections critiques |
| AdapterControl | Lance des opérations DMA. | Objets adaptateurs et DMA |
| IoCompletion | Termine le traitement d’un IRP par un pilote. | Exécution des programmes d’intégration |
| Annuler | Annule le traitement d’un IRP par un pilote. | Annulation des IRPs |
| CustomTimerDpc, IoTimer | Minutage et synchronisation des événements. | Techniques de synchronisation |
L’IRP actuel et l’objet d’appareil cible sont des paramètres d’entrée pour de nombreuses routines standard. Chaque pilote traite chaque IRP par étapes à travers son ensemble de routines standard.
Par convention, les pilotes fournis par le système ont ajouté un préfixe d’identification, spécifique au pilote ou spécifique au périphérique au nom de chaque routine standard, à l’exception de DriverEntry. À titre d’exemple, cette documentation utilise « DD », comme illustré dans Présentation des objets de pilote. En suivant cette convention, il est plus facile de déboguer et de gérer les pilotes.