Named Pipe – Zustand

Artikel
06/19/2023

Bei diesem automatisierten Test wird das Verhalten aller Named Pipe-Vorgänge für jeden individuellen Zustand einer Pipe-Instanz überprüft.

Im Rahmen des Tests werden folgende Zustände ausgewertet:

NO_INSTANCE: Die Instanz ist nicht vorhanden.
SERVER_ONLY: Die Serverseite der Instanz wurde erstellt.
CONNECTED: Die Clientseite wurde erstellt und stellt eine Verbindung mit dem Server her.
CLIENT_DISCONNECTED: Die Verbindung wird clientseitig durch Schließen des Handles getrennt.
SERVER_DISCONNECTED: Die Verbindung wird serverseitig unter Verwendung der API DisconnectNamedPipe getrennt.

Die vom Test ausgewerteten Named Pipe-Vorgänge umfassen Folgendes:

Server CreateNP: Der Server ruft CreateNamedPipe auf.
Server ConnectNP: Der Server ruft ConnectNamedPipe auf.
Server DisconnectNP: Der Server ruft DisconnectNamedPipe auf.
Server CloseHandle: Der Server ruft CloseHandle auf.
Client CreateFile: Der Client ruft CreateFile auf.
Client WaitNP: Der Client ruft WaitNamedPipe auf.
Client CallNP: Der Client ruft CallNamedPipe auf.
Client CloseHandle: Der Client ruft CloseHandle auf.
Server Write: Der Server ruft WriteFile auf.
Server Read: Der Server ruft ReadFile auf.
Client Write: Der Client ruft WriteFile auf.
Client Read: Der Client ruft ReadFile auf.

Der Test wählt die einzelnen Zustände in zufälliger Reihenfolge aus und ruft jede Aktion in zufälliger Reihenfolge auf. Wenn eine Aktion den aktuellen Zustand der Pipe ändert, wird sie vom Test wieder in den aktuellen Zustand versetzt.

Testdetails


Spezifikationen	Filter.Driver.FileSystem.MiniFilter Filter.Driver.AntiVirus.MiniFilter Filter.Driver.FileSystem.NamedPipeAndMailSlots Filter.Driver.AntiVirus.NamedPipeAndMailSlots
Plattformen	Windows 10, Client-Editionen (x86) Windows 10, Client-Editionen (x64) Windows Server 2016 (x64)
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)	30
Kategorie	Entwicklung
Zeitüberschreitung (in Minuten)	1800
Neustart erforderlich	false
Erfordert eine spezielle Konfiguration	false
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:

Filter.Driver – Zusätzliche Dokumentation

Ausführen des Tests

Weitere Informationen zu den Anforderungen finden Sie unter Voraussetzungen für Dateisystemtests.

Gehen Sie zum Durchführen dieses Tests wie folgt vor:

Kopieren Sie die im Abschnitt Dateiliste aufgeführten Binärdateien für den Test in die lokale Umgebung.
Führen Sie den folgenden Befehl aus: npstate.exe regress
Der erwartete Wert für das Bestehen ist 600. Überprüfen Sie die Protokolldatei auf die Anwesenheit von Fehlertags des Typs „+SEV“. Wenn Sie keine Vorkommen dieses Tags finden, wurde der Test bestanden.

Problembehandlung

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

Informationen zur Problembehandlung finden Sie unter Problembehandlung bei Dateisystemtests.

Dieser Test gibt „Pass“ oder „Fail“ zurück. Überprüfen Sie die Testdetails im Testprotokoll von Windows Hardware Lab Kit (Windows HLK) Studio.

Weitere Informationen

Befehlssyntax

Dieser Test akzeptiert einen einzelnen Parameter, der den Hostnamen des Servers angibt.

Dateiliste

Datei	Standort
Npstate.exe	[WTT\TestBinRoot]\NTTEST\BASETEST\kernel\misc\npstate.exe
Ntlog.dll	[WTT\OsBinRoot]\ddk_flat\DTM\tests\ntlog\ntlog.dll
Ntlogger.ini	[WTT\OsBinRoot]\ddk_flat\DTM\tests\ntlog\ntlogger.ini

Parameter

Parametername	Parameterbeschreibung
LLU_LclAdminUser	LLU zum Ausführen
LLU_NetAccessOnly	LLU zum Kopieren

Freigeben über