SD-Ioctl Test

  • Article

This test verifies that SD-specific IOCTL calls work from any user mode process as expected.

Test details

   
Specifications
  • Device.Storage.Controller.SD.BasicFunction
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) 5
Category Development
Timeout (in minutes) 300
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, complete the test setup as described in the test requirements: WDTF System Fundamentals Testing Prerequisites.

The test expects that an SD card is inserted into the host controller and working before the test begins.

Troubleshooting

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

The test sends several variations of IOCTLs to the disk and validates the response. In the case of an error sending the IOCTL or validating the response, the logs contain information about the errors. To check the WTT trace, perform the following steps:

  • View Task Log of Run SDIOCTL Test.

  • Open the log file sdioctltst.wtl.

  • Check for messages that may solve the issue.

For additional troubleshooting information, see Troubleshooting System Fundamentals Testing.

More information

The test will go through a series of IOCTLs and various parameters surrounding those IOCTLs. It will send them to the underlying disk and validate the response conforms to the requirements. Log information about which IOCTLs and the results are printed as tests cases in the log.

The following is a list of the IOCTLs that are covered in this file:

  1. IOCTL_DISK_MEDIA_REMOVAL

  2. IOCTL_DISK_GET_LENGTH_INFO

  3. IOCTL_DISK_IS_WRITABLE

  4. IOCTL_DISK_VERIFY

  5. IOCTL_STORAGE_CHECK_VERIFY

  6. IOCTL_STORAGE_CHECK_VERIFY2

  7. IOCTL_DISK_CHECK_VERIFY

  8. IOCTL_DISK_GET_CACHE_INFORMATION

  9. IOCTL_STORAGE_GET_HOTPLUG_INFO

  10. IOCTL_STORAGE_SET_HOTPLUG_INFO

  11. IOCTL_STORAGE_GET_DEVICE_NUMBER

  12. IOCTL_DISK_GET_DRIVE_GEOMETRY

  13. IOCTL_DISK_GET_DRIVE_GEOMETRY_EX

  14. IOCTL_STORAGE_GET_MEDIA_TYPES_EX

  15. IOCTL_STORAGE_QUERY_PROPERTY

  16. IOCTL_SCSI_GET_ADDRESS

  17. IOCTL_STORAGE_GET_MEDIA_SERIAL_NUMBER

  18. IOCTL_SFFDISK_QUERY_DEVICE_PROTOCOL

  19. IOCTL_SFFDISK_DEVICE_COMMAND

  20. IOCTL_SFFDISK_DEVICE_PASSWORD

Parameters

Parameter name Parameter description
LLU_NetAccessOnly
WDKDeviceID Instance path of device to test.