DF - Fuzz zero length buffer IOCTL test (Reliability)
During the Zero-Length Buffer Test, the Fuzz test issues a series of calls to the DeviceIoControl function with input and/or output buffer lengths of 0. The test generates varying I/O control codes by using different function codes, device types, data transfer methods, and access requirements. For information about the contents of I/O control codes, see Defining I/O Control Codes.
To test the driver's handling of invalid buffer pointers, the buffer pointers in these user-mode calls specify addresses high in kernel virtual address space, such as 0xFFFFFC00).
The Fuzz test performs the Zero-Length Buffer test on all devices opened during the basic and additional open tests. You can customize this test by using the MinFunctionCode and MaxFunctionCode command parameters to specify the range of IOCTL function codes used in the calls and MinDeviceType and MaxDeviceType to specify the range of device types used in the calls.
- Test binary: Devfund_FuzzTest.dll
- Test method: DoZeroLengthBufferIOCTLTest
Test details
| Specifications |
|
| Platforms |
|
| Supported Releases |
|
| Expected run time (in minutes) | 15 |
| Category | Scenario |
| Timeout (in minutes) | 180 |
| 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'. |
| ChangeBufferProtectionFlags | True or False. Changes the memory protection flags of buffers passed to the tested device. The memory protection flags alternates between no access, read-only, and read-only with page guard. |
| Impersonate | True or False. Runs the test as a non administrative user. |
| FillZeroPageWithNull | True or False. Maps the zero page and fills it with NULL values. This test identifies drivers that do not verify a pointer reference before dereferencing a pointer. |
| DoPoolCheck | True or False. Monitors the driver's use of the paged and nonpaged system memory pools by using pool tags and lookaside lists. This option also monitors changes in the number of exceptions handled which might indicate errors in exception handling. |
| DoSync | True or False. Also opens device handles in SYNC mode (FILE_SYNCHRONOUS_IO_ALERT). Random read and write operations are skipped. |
| TestCycles | Number of test cycles. |
| DriverVerifierAdditionalDrivers | Additional drivers that should have Driver Verifier enabled |
| DriverVerifierExcludedFlags | Placeholder for Driver Verifier flags that may be manually excluded for the test run |
| WDKDeviceID | Device id of device under test |
| QueryHardwareID | Hardware id of device under test |
| 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 |
| DriverVerifierCustomizeConfiguration | Specifies that this test may want to automatically update Driver Verifier settings |
| MinDeviceType | Specifies the minimum value of the DeviceType field in the IOCTLs. The minimum possible value is 0. Use -1 for automatic type detection (preferred). |
| MaxDeviceType | Specifies the maximum value of the DeviceType field in the IOCTLs. The maximum possible value is 65535. Use -1 for automatic type detection (preferred). |
| MinFunctionCode | Specifies the minimum value of the FunctionCode field in the IOCTLs. The minimum possible value is 0. |
| MaxFunctionCode | Specifies the maximum value of the FunctionCode field in the IOCTLs. The maximum possible value is 4095. |