Richtlinien für das Portieren von Legacyfiltertreibern

Entwickler werden ermutigt, ältere Filtertreiber auf das Filter-Manager-Modell zu portieren, um eine bessere Funktionalität für ihre Filtertreiber zu erhalten und die Systemzu zuverlässigkeit zu verbessern. Erfahrene Entwickler sollten es relativ einfach finden, einen Legacyfiltertreiber auf einen Minifiltertreiber zu portieren. Filtertreiberentwickler bei Microsoft empfehlen den folgenden Ansatz:

• Beginnen Sie mit einer zuverlässigen Regressionstestsuite, um das Verhalten zwischen dem Legacyfiltertreiber und dem portierten Minifiltertreiber zu überprüfen.

• Erstellen Sie eine Minifiltertreibershell, und verschieben Sie die Funktionalität systematisch vom Legacyfiltertreiber in den Minifiltertreiber. Sie können z. B. die Anlage zum Arbeiten bringen und dann einen Vorgang gleichzeitig portieren und nach jedem Vorgang testen.

• Ändern Sie zuletzt die Kommunikation zwischen Benutzermodus und Kernelmodus, sodass Sie vorhandene Tools verwenden können, um den Minifiltertreiber zu testen.

• Kompilieren Sie mit PREfast, und testen Sie mit aktivierter Option Filter Verifier E/A-Überprüfung in der Treiberüberprüfung.

Während des Portierungsprozesses sollten Sie den gesamten Legacy-Filtertreibercode überprüfen, um die Funktionen des Filter-Managers in vollem Umfang zu nutzen. Beachten Sie insbesondere Folgendes:

• IRP-basierte E/A-Vorgänge und schnelle E/A-Vorgänge können bei Bedarf denselben Vorgang durchlaufen, was zur Verringerung von Codeduplizierungen beiträgt.

• Bei der Registrierung für Vorgänge kann ein Minifiltertreiber explizit auswählen, dass er alle aus Paging-E/A und zwischengespeicherten E/A-Vorgänge ignoriert, sodass kein Code mehr erforderlich ist, um diese zu überprüfen.

• Instanzbenachrichtigungen vereinfachen die Logik zum Anfügen/Trennen erheblich.

• Registrieren Sie sich nur für Vorgänge, die Ihr Minifiltertreiber verarbeiten muss. Sie können alles andere ignorieren.

• Nutzen Sie die Unterstützung für den Kontext und die Namensverwaltung des Filter-Managers.

• Nutzen Sie die Filter-Manager-Unterstützung für die Ausgabe nicht rekursiver E/A.

• Im Gegensatz zu Legacyfiltertreibern können Minifiltertreiber nicht auf lokale Variablen angewiesen sein, um den Kontext von der Präoperationsverarbeitung bis zur Postoperationsverarbeitung beizubehalten. Erwägen Sie, eine Suchliste zuzuweisen, um den Vorgangsstatus zu speichern.

• Stellen Sie sicher, dass Verweise freigegeben werden, wenn sie mit einem Namen oder Kontext abgeschlossen sind.

• Vervollständigungsports im Benutzermodus fügen eine leistungsfähige Technik zum Erstellen von Warteschlangen hinzu. Sie benötigen wahrscheinlich nur eine einzelne Verbindung mit einem einzelnen benannten Port.

In der folgenden Tabelle sind allgemeine Vorgänge in einem Legacyfiltertreiber und deren Zuordnung zum Filter-Manager-Modell aufgeführt.