Freigeben über

Aktivieren der Fehlerinjektion

  • Artikel

Das WdfTester-Tool stellt eine WMI-Schnittstelle zum Konfigurieren der DDI-Fehlerinjektion für einen bestimmten Treiber bereit. Es wird ein Skript (WdftesterScript.wsf) bereitgestellt, das diese WMI-Schnittstelle zum Konfigurieren der Fehlerinjektion verwendet. Sie können entweder Ihr eigenes Skript schreiben oder das bereitgestellte Skript verwenden, um die Fehlerinjektion zu aktivieren. Sie können ein Skript (WdftesterScript.wsf) über ein Eingabeaufforderungsfenster ausführen, um einen Treiber zu registrieren, zu konfigurieren und die Registrierung aufzuheben. Das Skript verfügt auch über eine Befehlszeilenoption namens runtest.

Funktionsweise der Runtest-Option

Die Option runtest führt einfache Deaktivierungs- und Aktivierungsvorgänge für einen Treiber aus. Diese Option veranschaulicht die Verwendung des Tools. Zunächst deaktiviert das Skript den angegebenen Treiber und aktiviert ihn dann. Dadurch kann WdfTester alle DDI-Aufrufe überwachen, die während der Deaktivierungs- und Aktivierungsvorgänge ausgeführt wurden. Das Skript verwendet eine der WMI-Schnittstellen, um die Liste der DDIs abzurufen, die während dieses Zeitraums aufgerufen wurden. Das Skript bestimmt, welche dieser DDIs fehlschlagen können (nur die, die NTSTATUS zurückgeben). Das Skript ruft dann eine weitere WMI-Schnittstelle auf, um WdfTester so zu konfigurieren, dass der erste DDI in der Liste fehlschlägt. Das Skript deaktiviert und aktiviert den Treiber, was dazu führt, dass der DDI fehlschlägt und ein WMI-Ereignis auslöst. Das Skript wartet bereits auf das WMI-Fail-Ereignis für den DDI. Wenn das Ereignis erfolgreich empfangen wurde und der Fehler nicht dazu geführt hat, dass der Computer nicht mehr reagiert oder eine Fehlerprüfung verursacht hat (wie vom Treiberentwickler oder -tester ermittelt), wird der Test als erfolgreich betrachtet. Das Skript wiederholt dann diese Schritte für den nächsten DDI in der Liste.

Hinweis Für die Option runtest müssen Sie das DevCon-Tool (Devcon.exe) kopieren und im selben Verzeichnis wie andere Wdftester-Dateien ablegen. Die Devcon.exe Anwendung befindet sich im Verzeichnis %WDKRoot%\tools\<platform> .

Die Option runtest:

  1. Registriert Ihren Treiber bei WdfTester. Wenn Sie Ihren Treiber nicht installiert haben, müssen Sie ihn installieren, bevor Sie runtest verwenden.

  2. Aktiviert die Treiberüberprüfung für diesen Treiber (Computer mit Windows Vista oder höher erfordern keinen Neustart).

  3. Deaktiviert den Treiber mithilfe der Devcon-Anwendung.

  4. Aktiviert den Treiber mithilfe der Devcon-Anwendung.

  5. Ruft die Namen der Funktionen ab, die während der Aktivierungs- und Deaktivierungsvorgänge aufgerufen wurden, und identifiziert die Funktionen, die NTSTATUS zurückgeben und möglicherweise fehlgeschlagen sind.

  6. Startet die asynchrone WMI-Ereignisbenachrichtigung.

  7. Für jeden DDI, bei dem ein Fehler in der in Schritt 5 abgerufenen Liste aufgetreten ist:

    1. Konfiguriert die Funktion für einen Fehler.
    2. Deaktiviert und aktiviert dann den Treiber mithilfe von Devcon.exe. Dieser Vorgang ruft die -Funktion auf, und WdfTester schlägt den Funktionsaufruf fehl.
    3. Wartet auf das Auslösen des WMI-Ereignisses.
    4. Wenn das WMI-Ereignis ausgelöst wird, wiederholt die Runtest-Option Schritt 7 für die nächste Funktion in der Liste.

  8. Hebt die Registrierung des Treibers auf.