SD-Ioctl Test

  • Article

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

Test details

Associated requirements

Device.Storage.Controller.SD.BasicFunction

See the device hardware requirements.

Platforms

Windows RT (ARM-based) Windows 8 (x64) Windows 8 (x86) Windows Server 2012 (x64) Windows RT 8.1 Windows 8.1 x64 Windows 8.1 x86 Windows Server 2012 R2

Expected run time

~5 minutes

Categories

Certification Functional

Type

Automated

 

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

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

Command usage

Command Description

sdioctltst.exe -c "[WDKDeviceID]"

Run the test for the specified device instance ID.

 

Command syntax

Command Description

sdioctltst.exe

The command-line options for the test are listed below.

-d

This can be either sffdisk or sdbus.

-n

The specific test number.

-c

The device instance ID of the controller.

 

File list

File Location

sdioctltst.exe

<[testbinroot]>\NTTest\testsrc\driverstest\storage\sd\ioctl\

 

 

 

Send comments about this topic to Microsoft