NDISTest 6.5 - LWF Logo test

This automated test targets LWF by validating that the all the requirements specified for the light weight filter driver are satisfied, and that they comply with NDIS specification on MSDN.

The test installs two of the NDISTest virtual miniports - "NDISTest 6.30 - CL - Default w/TCPIP", which would be used as the test and support adapters for running the LWF logo test. These virtual miniports are uninstalled in the cleanup phase of the test.

Windows 8 has a requirement that all NDIS LWF drivers are NDIS 6.30. This is validated by ConfigCheck test, which will fail the filter logo test if the Filter driver is not NDIS 6.30.

ConfigCheck test also validates that the Filter driver selected as the target, is actually bound to the test adapter, and an error is thrown if the filter is not bound to the test adapter.

It is also validated that the filter driver is able to process packets that are larger than miniport's MTU size.

This also runs a filter stress test which is designed to stress the datapath and PnP paths of NDIS filter drivers.  The test will limit the test virtual miniport's receive descriptors such that a significant number of receive indications will happen with the receive resources flag.  This test performs the following actions in a multi-threaded way:

  • Stress traffic from the support miniport directed to the test miniport

  • Stress traffic from the test miniport directed to the support miniport

  • Stop/start the test miniport (which triggers a pause and subsequent restart operations)

  • Test adapter indicating media disconnected/connected

  • Test adapter resetting

Finally, basic send and receive connectivity will be tested between the test/support adapters.

Test details

   
Specifications
  • Filter.Driver.Network.LWF.Base
  • Filter.Driver.Network.LWF.MTUSize
Platforms
  • Windows 10, client editions (x86)
  • Windows 10, client editions (x64)
  • Windows Server 2016 (x64)
Supported Releases
  • 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
  • Next update to Windows 10
Expected run time (in minutes) 2
Category Development
Timeout (in minutes) 120
Requires reboot false
Requires special configuration false
Type automatic

 

Additional documentation

Tests in this feature area might have additional documentation, including prerequisites, setup, and troubleshooting information, that can be found in the following topic(s):

Running the test

Before you run the test, you need to manually install your filter driver on the test machine.

Follow these steps to run the test:

  1. Configure the HLK Server and HLK Client machines. Filter Logo tests need just the one client machine.

  2. Install the Light Weight Filter driver on the Client machine.

  3. Restart the Client machine.

  4. From the HLK Server, add the client on which the LWF is installed to a new machine pool, and change the machine status to 'Ready'.

  5. From HLK studio, create a new project under the Project tab in HLK Studio.

  6. In the Selection tab of the HLK studio, select the machine pool that was created in the previous steps from the dropdown.

  7. Select software device, and select the LightWeightFilter driver that was installed and needs to be tested (see the following figure).

    select filter driver

  8. Run all of the tests listed in the Tests tab against the filter driver.

Troubleshooting

For generic troubleshooting of HLK test failures, see Troubleshooting Windows HLK Test Failures.

For troubleshooting information, see Troubleshooting the Windows HLK Environment.

More information

Parameters

Parameter name Parameter description
TestAdapter
SupportAdapter
TestScript
queryFilterService ServiceName of the filter selected as target