Named Pipe State
This automated test validates the behavior of all named-pipe operations for each distinct state of a pipe instance.
The test evaluates the following states:
NO_INSTANCE. The instance does not exist.
SERVER_ONLY. The server side of the instance has been created.
CONNECTED. The client side has been created and connects to server.
CLIENT_DISCONNECTED. The client disconnects by closing its handle.
SERVER_DISCONNECTED. The server disconnects by using the DisconnectNamedPipe API.
The named-pipe operations that the test evaluates include the following:
Server CreateNP. Server calls CreateNamedPipe.
Server ConnectNP. Server calls ConnectNamedPipe.
Server DisconnectNP. Server calls DisconnectNamedPipe.
Server CloseHandle. Server calls CloseHandle.
Client CreateFile. Client calls CreateFile.
Client WaitNP. Client calls WaitNamedPipe.
Client CallNP. Client calls CallNamedPipe.
Client CloseHandle. Client calls CloseHandle.
Server Write. Server calls WriteFile.
Server Read. Server calls ReadFile.
Client Write. Client calls WriteFile.
Client Read. Client calls ReadFile.
The test selects each state in random order and calls each action in random order. If any action moves the pipe away from the current state, the test brings it back to the current state.
Test details
Associated requirements |
Filter.Driver.AntiVirus.MiniFilter Filter.Driver.AntiVirus.NamedPipeAndMailSlots Filter.Driver.FileSystem.MiniFilter Filter.Driver.FileSystem.NamedPipeAndMailSlots |
Platforms |
Windows 8 (x64) Windows 8 (x86) Windows Server 2012 (x64) Windows 8.1 x64 Windows 8.1 x86 Windows Server 2012 R2 |
Expected run time |
~30 minutes |
Categories |
Certification Functional |
Type |
Automated |
Running the test
For more information about requirements, see File System Testing Prerequisites.
To run this test, follow these steps:
Copy the test binaries that are listed in the File List section locally.
Run the following command: npstate.exe regress
The expected Pass count is 600. Inspect the log file for the presence of +SEV error tags. If you do not find any instances of this tag, the test has passed.
Troubleshooting
For troubleshooting information, see Troubleshooting File System Testing.
This test returns Pass or Fail. To review test details, review the test log from Windows Hardware Certification Kit (Windows HCK) Studio.
More information
Command syntax
This test accepts a single parameter that indicates the server host name.
File list
| File | Location |
|---|---|
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 |