General Storage I/O Control Codes
Storage devices of different kinds often require the same services. Rather than duplicate the IOCTL requests that provide these services for each device type, this section defines a set of standard services and accompanying device control codes that are frequently required by storage devices. The I/O control codes defined here have the form IOCTL_STORAGE_XXX and they replace the IOCTL_DeviceType_XXX control codes, where DeviceType was DISK, TAPE, or CDROM. For example, IOCTL_STORAGE_RESERVE replaces IOCTL_DISK_RESERVE, IOCTL_TAPE_RESERVE, and IOCTL_CDROM_RESERVE. The IOCTL_STORAGE_XXX control codes have identical values for function code, transfer method, and required access as the previous disk, tape, and CD-ROM codes. The only difference is the device type.
The storage class driver initiates some of these requests, but usually it is an application that does so. Storage class drivers must handle some or all of these requests, depending on the type of storage device. Where no storage class driver exists, the application might make the request directly to the port driver.
| IOCTL | Description |
|---|---|
| IOCTL_STORAGE_BREAK_RESERVATION | Breaks a disk reservation. |
| IOCTL_STORAGE_CHECK_VERIFY | Determines whether the media has changed on a removable-media device that the caller has opened for read or write access. |
| IOCTL_STORAGE_CHECK_VERIFY2 | Determines whether the media has changed on a removable-media device - the caller has opened with FILE_READ_ATTRIBUTES. |
| IOCTL_STORAGE_DEVICE_POWER_CAP | Specifies a maximum operational power consumption level for a storage device. |
| IOCTL_STORAGE_EJECT_MEDIA | Causes the device to eject the media if the device supports ejection capabilities. |
| IOCTL_STORAGE_EJECTION_CONTROL | Locks the device to prevent removal of the media. |
| IOCTL_STORAGE_FIND_NEW_DEVICES | Determines whether another device that the driver supports has been connected to the I/O bus, either since the system was booted or since the driver last processed this request. |
| IOCTL_STORAGE_FIRMWARE_ACTIVATE | Activates a firmware image on a storage device. |
| IOCTL_STORAGE_FIRMWARE_DOWNLOAD | Downloads a firmware image to a storage device, but does not activate it. |
| IOCTL_STORAGE_FIRMWARE_GET_INFO | Queries a storage device for detailed firmware information. |
| IOCTL_STORAGE_GET_DEVICE_NUMBER | Returns a STORAGE_DEVICE_NUMBER structure that contains the FILE_DEVICE_XXX type, device number, and, for a partitionable device, the partition number assigned to a device by the driver when the device is started. |
| IOCTL_STORAGE_GET_HOTPLUG_INFO | Retrieves the hotplug configuration of the specified device. |
| IOCTL_STORAGE_GET_LB_PROVISIONING_MAP_RESOURCES | The IOCTL_STORAGE_GET_LB_PROVISIONING_MAP_RESOURCES request is sent to the storage class driver to determine available and used mapping resources on a storage device. |
| IOCTL_STORAGE_GET_MEDIA_SERIAL_NUMBER | Queries the USB generic parent driver for the serial number of a USB device. |
| IOCTL_STORAGE_GET_MEDIA_TYPES | Returns information about the geometry of floppy drives. |
| IOCTL_STORAGE_GET_MEDIA_TYPES_EX | Returns information about the types of media supported by a device. |
| IOCTL_STORAGE_GET_PHYSICAL_ELEMENT_STATUS | The IOCTL_STORAGE_GET_PHYSICAL_ELEMENT_STATUS control code queries for and returns the physical element status from a device. |
| IOCTL_STORAGE_LOAD_MEDIA | Causes media to be loaded in a device that the caller has opened for read or write access. |
| IOCTL_STORAGE_LOAD_MEDIA2 | Causes media to be loaded in a device that the caller has opened with FILE_READ_ATTRIBUTES. |
| IOCTL_STORAGE_MANAGE_DATA_SET_ATTRIBUTES | This IOCTL_STORAGE_MANAGE_DATA_SET_ATTRIBUTES request is used to send a manage data set attributes request to a storage device. |
| IOCTL_STORAGE_MCN_CONTROL | Temporarily enables or disables delivery of the custom PnP events GUID_IO_MEDIA_ARRIVAL and GUID_IO_MEDIA_REMOVAL on a removable-media device. |
| IOCTL_STORAGE_MEDIA_REMOVAL | Locks the device to prevent removal of the media. |
| IOCTL_STORAGE_PERSISTENT_RESERVE_IN | The generic storage class driver (classpnp.sys) exposes an I/O control (IOCTL) interface for issuing Persistent Reserve In commands. |
| IOCTL_STORAGE_PERSISTENT_RESERVE_OUT | The generic storage class driver (classpnp.sys) exposes an I/O control (IOCTL) interface for issuing Persistent Reserve Out commands. |
| IOCTL_STORAGE_PREDICT_FAILURE | Polls for a prediction of device failure. |
| IOCTL_STORAGE_PROTOCOL_COMMAND | A driver can use IOCTL_STORAGE_PROTOCOL_COMMAND to pass vendor-specific commands to a storage device |
| IOCTL_STORAGE_QUERY_PROPERTY | A driver can use IOCTL_STORAGE_QUERY_PROPERTY to return properties of a storage device or adapter. |
| IOCTL_STORAGE_READ_CAPACITY | The IOCTL_STORAGE_READ_CAPACITY request returns the read capacity information for the target storage device. |
| IOCTL_STORAGE_REINITIALIZE_MEDIA | A driver can use the IOCTL_STORAGE_REINITIALIZE_MEDIA control code to reinitialize/erase a device. |
| IOCTL_STORAGE_RELEASE | Releases a device previously reserved for the exclusive use of the caller on a bus that supports multiple initiators and the concept of reserving a device, such as a SCSI bus. |
| IOCTL_STORAGE_RESERVE | Claims a device for the exclusive use of the caller on a bus that supports multiple initiators and the concept of reserving a device, such as a SCSI bus. |
| IOCTL_STORAGE_RESET_BUS | Resets an I/O bus and, indirectly, each device on the bus. |
| IOCTL_STORAGE_RESET_DEVICE | If possible, resets a non-SCSI storage device without affecting other devices on the bus. |
| IOCTL_STORAGE_SET_HOTPLUG_INFO | Sets the hotplug configuration of the specified device. |
| IOCTL_STORAGE_SET_PROPERTY | Indicates whether a request to change a property is successful or causes an error. |
| IOCTL_STORAGE_SET_TEMPERATURE_THRESHOLD | A driver can use IOCTL_STORAGE_SET_TEMPERATURE_THRESHOLD to set the temperature threshold of a storage device (when supported by the hardware). |