Freigeben über

DF – PNP – Test zum Beenden von Geräten (Neuausgleich) (Entwicklung und Integration)

  • Artikel

Dieser Test initiiert eine Neuausgleich-Prozedur, für die der Gerätetreiber den IRP „IRP_MN_QUERY_STOP_DEVICE PnP“ erhält.

Wenn dieser IRP bei einem Treiber im Stapel fehlschlägt, wird die Neuausgleich-Prozedur abgebrochen. Bitte beachten Sie, dass Windows Vista einen mehrstufigen Neuausgleich unterstützt. Wenn ein Neuausgleich auf einem Geräteknoten gestartet wird, der kein Blatt ist, wird der Neuausgleich für alle im Gerätebaum vorhandenen Gerätestapel, deren Stamm dieser Geräteknoten ist, ebenfalls ausgeführt. Wenn in einem untergeordneten Gerätestapel der Abfragestopp fehlschlägt, wird die gesamte Neuausgleich-Prozedur abgebrochen. Daher darf es bei den Treibern zu keinem Fehlschlag des Abfragestopps kommen, wenn es dafür keinen konkreten Grund gibt. Wenn ein solcher Fehler auftritt, sendet der PnP-Manager den Abbruchstopp (IRP_MN_CANCEL_STOP) an alle Gerätestapel, an die der Abfragestopp gesendet wurde.

Wenn alle beteiligten Gerätestapel den Abfragestopp akzeptieren, wird der Test fortgesetzt und sendet die IRPs „IRP_MN_QUERY_RESOURCE_REQUIREMENTS“ und „IRP_MN_FILTER_RESOURCE_REQUIREMENTS“, um die Ressourcenanforderung der Geräte zu finden.

Nach diesem Punkt gibt es zwei verschiedene Möglichkeiten, je nachdem, ob das Zielgerät Ressourcen verbraucht oder nicht:

  • Wenn das Gerät keine Ressourcen verbraucht, sendet der PnP-Manager selbst einen Abbruchstopp (IRP_MN_CANCEL_STOP_DEVICE) als Optimierung.

    Wenn das Gerät tatsächlich Ressourcen verbraucht, wird das Neuausgleich-Verfahren mit den IRPs „IRP_MN_STOP_DEVICE“ und „IRP_MN_START_DEVICE“ abgeschlossen.

Bei diesem Test ändern sich die Ressourcen des Geräts nicht.

  • Testbinärdatei: Devfund_PnPDTest.dll
  • Testmethode: PNPTryStopAndRestartDevice

Der Test Disable Enhanced Device Testing (EDT) Support deinstalliert den Testfiltertreiber (msdmfilt.sys) als oberen Filter auf Geräten, die mit dem DQ-Parameter angegeben wurden. Dieser Testfilter wird als Teil der Testausführung in dieser Testkategorie installiert

  • Binärdatei testen: Devfund_PnPDTest.dll
  • Testmethode: DisableEnhancedDeviceTestingSupport

Testdetails

   
Spezifikationen
  • Device.DevFund.Reliability.Discretional
Plattformen
  • Windows 10, Client-Editionen (x86)
  • Windows 10, Client-Editionen (x64)
  • Windows Server 2016 (x64)
  • Windows 10, Client-Editionen (Arm64)
  • Windows 10, mobile Edition (Arm)
  • Windows 10, mobile Edition (Arm64)
Unterstützte Versionen
  • Windows 10
  • Windows 10, Version 1511
  • Windows 10, Version 1607
  • Windows 10, Version 1703
  • Windows 10, Version 1709
  • Windows 10, Version 1803
  • Windows 10, Version 1809
  • Windows 10, Version 1903
  • Nächstes Update auf Windows 10
Voraussichtliche Laufzeit (in Minuten) 3
Kategorie Szenario
Zeitüberschreitung (in Minuten) 45
Neustart erforderlich false
Erfordert eine spezielle Konfiguration true
Typ automatic

 

Zusätzliche Dokumentation

Tests in diesem Funktionsbereich enthalten möglicherweise zusätzliche Dokumentation, einschließlich Informationen zu Voraussetzungen, Einrichtung und Fehlerbehebung, die in den folgenden Themen zu finden sind:

Ausführen des Tests

Bevor Sie den Test ausführen, vervollständigen Sie die Testeinrichtung wie in den Testanforderungen beschrieben: Device.Fundamentals Reliability Testing Prerequisites.

Problembehandlung

Informationen zur allgemeinen Problembehandlung bei HLK-Testfehlern finden Sie unter Problembehandlung bei Windows HLK-Testfehlern.

Informationen zur Problembehandlung speziell für die Device Fundamentals-Tests im HLK und WDK finden Sie in der zusätzlichen Dokumentation zu Device.DevFund.

Weitere Informationen

Parameter

Parametername Parameterbeschreibung
DQ Eine WDTF-SDEL-Abfrage, die verwendet wird, um das/die Zielgerät(e) zu identifizieren - https://go.microsoft.com/fwlink/?LinkId=232678
Wpa2PskAesSsid NUR erforderlich, wenn das DUT oder eines seiner untergeordneten Geräte ein WiFi-Adapter ist. Bitte geben Sie die SSID eines WPA2-AES-WLAN-Netzwerks an, das der Test zum Testen des WLAN-Adapters verwenden kann. Der Standardwert ist ‚kitstestssid‘.
Wpa2PskPassword NUR erforderlich, wenn das DUT oder eines seiner untergeordneten Geräte ein WiFi-Adapter ist. Bitte geben Sie das Passwort des WPA2-AES-WLAN-Netzwerks ein, das mit dem Parameter Wpa2PskAesSsid angegeben wurde. Der Standardwert ist ‚Passwort‘.
WDTFREMOTESYSTEM NUR erforderlich, wenn das DUT oder eines seiner untergeordneten Geräte eine kabelgebundene NIC ist, die keine IPv6-Gateway-Adresse hat. Falls erforderlich, geben Sie bitte eine IPv6-Adresse an, die die Test-NIC anpingen kann, um die Netzwerk-E/A zu testen. Eg: fe80::78b6:810:9c12:46cd
DriverVerifierAdditionalDrivers Zusätzliche Treiber, für die die Treiberüberprüfung aktiviert sein sollte
DriverVerifierExcludedFlags Platzhalter für Treiberüberprüfungs-Flags, die manuell für den Testlauf ausgeschlossen werden können
MultiDeviceHardwareIdSdelQueryHardwareID SDEL für mehrere Geräte
MultiDeviceInstanceIdSdelWDKDeviceID Geräte-ID des DUT
DriverVerifierCustomizeConfiguration Gibt an, dass dieser Test möglicherweise die Einstellungen der Treiberüberprüfung automatisch aktualisieren möchte
TestCycles Anzahl der Zyklen, für die der Test ausgeführt werden soll.
DoSimpleIO Richtig oder falsch. Führt SimpleIO (sofern vorhanden) auf Testgeräten aus, bevor und nachdem PNP-Operationen durchgeführt werden.
IOPeriod Zeitraum in Minuten zum Ausführen von SimpleIO (falls gefunden).
DoConcurrentIO Richtig oder falsch. Verwendet die gleichzeitige WDTF-E / A-Schnittstelle, um E / A-Anforderungen an Zielgerätestapel zu senden, während PNP-Operationen ausgeführt werden.