Einführung in Standardtreiberroutinen
Jeder Kernelmodustreiber wird um eine Reihe systemdefinierter Standardtreiberroutinen herum erstellt. Kernelmodustreiber verarbeiten E/A-Anforderungspakete (IRPs) innerhalb dieser Standardroutinen, indem sie vom System bereitgestellte Treiberunterstützungsroutinen aufrufen.
Alle Treiber, unabhängig von ihrem Niveau in einer Kette angefügter Treiber, müssen über einen grundlegenden Satz von Standardroutinen verfügen, um IRPs verarbeiten zu können. Ob ein Treiber zusätzliche Standardroutinen implementieren muss, hängt davon ab, ob der Treiber ein physisches Gerät steuert oder sich über einen physischen Gerätetreiber befindet, sowie von der Art des zugrunde liegenden physischen Geräts. Treiber der niedrigsten Ebene, die physische Geräte steuern, verfügen über mehr erforderliche Routinen als Treiber auf höherer Ebene, die IRPs normalerweise zur Verarbeitung an einen niedrigeren Treiber übergeben.
Standardtreiberroutinen können in zwei Gruppen unterteilt werden: diejenigen, die jeder Kernelmodustreiber aufweisen muss, und diejenigen, die optional sind, je nach Treibertyp und Speicherort im Gerätestapel.
In der folgenden Tabelle sind die erforderlichen Standardroutinen aufgeführt.
| Erforderliche Standardtreiberroutinen | Zweck | Wo beschrieben |
|---|---|---|
| DriverEntry | Initialisiert den Treiber und sein Treiberobjekt. | Schreiben einer DriverEntry-Routine |
| AddDevice | Initialisiert Geräte und erstellt Geräteobjekte. | Schreiben einer AddDevice-Routine |
| Versandroutinen | Empfangen und Verarbeiten von IRPs. | Schreiben von Dispatchroutinen |
| Entladen | Geben Sie Systemressourcen frei, die vom Treiber abgerufen wurden. | Schreiben einer Entladeroutine |
In der folgenden Tabelle sind mehrere optionale Routinen aufgeführt.
| Optionale Standardtreiberroutinen | Zweck | Wo beschrieben |
|---|---|---|
| Initialisieren | Schließt die Treiberinitialisierung ab, wenn DriverEntry dies nicht kann. | Schreiben einer Neuitialisierungsroutine |
| StartIo | Startet einen E/A-Vorgang auf einem physischen Gerät. | Schreiben einer StartIo-Routine |
| Unterbrechung der Dienstroutine | Speichert den Zustand eines Geräts, wenn es unterbrochen wird. | Schreiben einer ISR |
| Verzögerte Prozeduraufrufe | Schließt die Verarbeitung eines Geräteunterbrechungs ab, nachdem ein ISR den Gerätestatus gespeichert hat. | DPC-Objekte und DPCs |
| SynchCritSection | Synchronisiert den Zugriff auf Treiberdaten. | Verwenden kritischer Abschnitte |
| AdapterControl | Initiiert DMA-Vorgänge. | Adapterobjekte und DMA |
| IoCompletion | Schließt die Verarbeitung eines IRP durch einen Treiber ab. | Abschließen von IRPs |
| Abbrechen | Bricht die Verarbeitung eines IRP durch einen Treiber ab. | Abbrechen von IRPs |
| CustomTimerDpc, IoTimer | Timing und Synchronisierung von Ereignissen. | Synchronisierungstechniken |
Das aktuelle IRP- und das Zielgerätobjekt sind Eingabeparameter für viele Standardroutinen. Jeder Treiber verarbeitet jedes IRP schrittweise über seine Standardroutinen.
Gemäß der Konvention haben die vom System bereitgestellten Treiber dem Namen jeder Standardroutine mit Ausnahme von DriverEntry ein identifizierende, treiberspezifisches oder gerätespezifisches Präfix vorangestellt. In dieser Dokumentation wird beispielsweise "DD" verwendet, wie in der Abbildung in Einführung in Treiberobjekte gezeigt. Die Einhaltung dieser Konvention erleichtert das Debuggen und Verwalten von Treibern.