DF - PNP Stop (Rebalance) Device Test (Development and Integration)
This test initiates a rebalance procedure which results in the IRP_MN_QUERY_STOP_DEVICE PnP IRP to the device driver.
If any driver in the stack fails this IRP the rebalance procedure is abandoned. Please note that in Windows Vista, there is support for multi-level rebalance. If a rebalance is started on a non-leaf device node, all of the device stacks that are present in the device tree with that device node as the root also go through rebalance. And if any of the child device stacks fails query stop, the whole rebalance procedure is abandoned. So drivers must not fail query stop without a genuine reason to do so. If this failure happens, the PnP manager sends cancel stop (IRP_MN_CANCEL_STOP) to all the device stacks that had been sent query stop.
If all of the device stacks involved pass query stop, the test continues with the rebalance and sends the IRP_MN_QUERY_RESOURCE_REQUIREMENTS and IRP_MN_FILTER_RESOURCE_REQUIREMENTS IRPS to find the resource requirement of the devices.
After this point, two different paths are possible depending on whether the target device consumes any resources or not:
If the device does not consume any resources, the PnP manager itself sends a cancel stop (IRP_MN_CANCEL_STOP_DEVICE) as an optimization.
If the device actually consumes resources, the rebalance procedure is completed with the IRP_MN_STOP_DEVICE and IRP_MN_START_DEVICE IRPs.
With this test, the resources of the device do not change.
- Test binary: Devfund_PnPDTest.dll
- Test method: PNPTryStopAndRestartDevice
The Disable Enhanced Device Testing (EDT) Support test uninstalls the test filter driver (msdmfilt.sys) as an upper filter on devices specified using the DQ parameter. This test filter gets installed as part of running tests in this test category
- Test binary: Devfund_PnPDTest.dll
- Test method: DisableEnhancedDeviceTestingSupport
Test details
Specifications |
|
Platforms |
|
Supported Releases |
|
Expected run time (in minutes) | 3 |
Category | Scenario |
Timeout (in minutes) | 45 |
Requires reboot | false |
Requires special configuration | true |
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, complete the test setup as described in the test requirements: Device.Fundamentals Reliability Testing Prerequisites.
Troubleshooting
For generic troubleshooting of HLK test failures, see Troubleshooting Windows HLK Test Failures.
For troubleshooting information specific to the Device Fundamentals tests in the HLK and WDK, see Device.DevFund additional documentation.
More information
Parameters
Parameter name | Parameter description |
---|---|
DQ | A WDTF SDEL query that is used to identify the target device(s) - https://go.microsoft.com/fwlink/?LinkId=232678 |
Wpa2PskAesSsid | Required ONLY if DUT or one of its child devices is a WiFi adapter. Please provide SSID of a WPA2 AES WiFi network that the test can use to test the WiFi adapter. The default is 'kitstestssid'. |
Wpa2PskPassword | Required ONLY if DUT or one of its child devices is a WiFi adapter. Please provide password of the WPA2 AES WiFi network specified using the Wpa2PskAesSsid parameter. The default is 'password'. |
WDTFREMOTESYSTEM | Required ONLY if DUT or one of its child devices is a wired NIC that doesn't have an IPv6 gateway address. If determined to be required, please provide an IPv6 address that the test NIC can ping to test network I/O. Eg: fe80::78b6:810:9c12:46cd |
DriverVerifierAdditionalDrivers | Additional drivers that should have Driver Verifier enabled |
DriverVerifierExcludedFlags | Placeholder for Driver Verifier flags that may be manually excluded for the test run |
MultiDeviceHardwareIdSdelQueryHardwareID | Multi Device SDEL |
MultiDeviceInstanceIdSdelWDKDeviceID | Device id of DUT |
DriverVerifierCustomizeConfiguration | Specifies that this test may want to automatically update Driver Verifier settings |
TestCycles | Number of cycles to run the test for. |
DoSimpleIO | True or False. Runs SimpleIO (if found) on test devices before and after performing PNP operations. |
IOPeriod | Time period in minutes to run SimpleIO (if found). |
DoConcurrentIO | True or False. Uses WDTF concurrent IO interface to send I/O requests to target device stacks while performing PNP operations. |