Named Pipe State

  • Articolo

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

See the filter hardware requirements.

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:

  1. Copy the test binaries that are listed in the File List section locally.

  2. Run the following command: npstate.exe regress

  3. 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

 

 

 

Send comments about this topic to Microsoft