This topic has not yet been rated - Rate this topic

STORAGE_PROPERTY_QUERY structure

Indicates the properties of a storage device or adapter to retrieve as the input buffer passed to the IOCTL_STORAGE_QUERY_PROPERTY control code.

Syntax

C++


typedef struct _STORAGE_PROPERTY_QUERY {
  STORAGE_PROPERTY_ID PropertyId;
  STORAGE_QUERY_TYPE  QueryType;
  BYTE                AdditionalParameters[1];
} STORAGE_PROPERTY_QUERY, *PSTORAGE_PROPERTY_QUERY;

Members

PropertyId

Indicates whether the caller is requesting a device descriptor, an adapter descriptor, a write cache property, a device unique ID (DUID), or the device identifiers provided in the device's SCSI vital product data (VPD) page. For a list of the property IDs that can be assigned to this member, see STORAGE_PROPERTY_ID.

Value	Meaning
StorageDeviceProperty 0	Indicates that the caller is querying for the device descriptor.
StorageAdapterProperty 1	Indicates that the caller is querying for the adapter descriptor.
StorageDeviceIdProperty 2	Indicates that the caller is querying for the device identifiers provided with the SCSI vital product data pages.
StorageDeviceUniqueIdProperty 3	Indicates that the caller is querying for the unique device identifiers. Windows Server 2003 and Windows XP: This value is not supported before Windows Vista and Windows Server 2008.
StorageDeviceWriteCacheProperty 4	Indicates that the caller is querying for the write cache property. Windows Server 2003 and Windows XP: This value is not supported before Windows Vista and Windows Server 2008.
StorageMiniportProperty 5	Indicates that the caller is querying for the miniport driver descriptor. Windows Server 2003 and Windows XP: This value is not supported before Windows Vista and Windows Server 2008.
StorageAccessAlignmentProperty 6	Indicates that the caller is querying for the access alignment descriptor. Windows Server 2003 and Windows XP: This value is not supported before Windows Vista and Windows Server 2008.
StorageDeviceSeekPenaltyProperty 7	Indicates that the caller is querying for the seek penalty descriptor. Windows Server 2008, Windows Vista, Windows Server 2003, and Windows XP: This value is not supported before Windows 7 and Windows Server 2008 R2.
StorageDeviceTrimProperty 8	Indicates that the caller is querying for the trim descriptor. Windows Server 2008, Windows Vista, Windows Server 2003, and Windows XP: This value is not supported before Windows 7 and Windows Server 2008 R2.
StorageDeviceWriteAggregationProperty 9	Indicates that the caller is querying for the write aggregation descriptor. Windows 7 and Windows Server 2008 R2: This value is not supported before Windows 8 and Windows Server 2012.
StorageDeviceDeviceTelemetryProperty 10 (0xA)	This value is reserved. Windows 7 and Windows Server 2008 R2: This value is not supported before Windows 8 and Windows Server 2012.
StorageDeviceLBProvisioningProperty 11 (0xB)	Indicates that the caller is querying for the logical block provisioning descriptor, usually to detect whether the storage system uses thin provisioning. Windows 7 and Windows Server 2008 R2: This value is not supported before Windows 8 and Windows Server 2012.
StorageDevicePowerProperty 12 (0xC)	Indicates that the caller is querying for the power disk drive descriptor. Windows 7 and Windows Server 2008 R2: This value is not supported before Windows 8 and Windows Server 2012.
StorageDeviceCopyOffloadProperty 13 (0xD)	Indicates that the caller is querying for the write offload descriptor. Windows 7 and Windows Server 2008 R2: This value is not supported before Windows 8 and Windows Server 2012.
StorageDeviceResiliencyProperty 14 (0xE)	Indicates that the caller is querying for the device resiliency descriptor. Windows 7 and Windows Server 2008 R2: This value is not supported before Windows 8 and Windows Server 2012.

QueryType

Contains flags indicating the type of query to be performed as enumerated by the STORAGE_QUERY_TYPE enumeration.

Value	Meaning
PropertyStandardQuery 0	Instructs the port driver to report a device descriptor, an adapter descriptor or a unique hardware device ID (DUID).
PropertyExistsQuery 1	Instructs the port driver to report whether the descriptor is supported.

AdditionalParameters

Contains an array of bytes that can be used to retrieve additional parameters for specific queries.

Remarks

The optional output buffer returned through the lpOutBuffer parameter of the IOCTL_STORAGE_QUERY_PROPERTY control code can be one of several structures depending on the value of the PropertyId member. If the QueryType member is set to PropertyExistsQuery, then no structure is returned.

Value	lpOutBuffer structure
StorageDeviceProperty (0)	STORAGE_DEVICE_DESCRIPTOR
StorageAdapterProperty (1)	STORAGE_ADAPTER_DESCRIPTOR
StorageDeviceIdProperty (2)	STORAGE_DEVICE_ID_DESCRIPTOR
StorageDeviceUniqueIdProperty (3)	STORAGE_DEVICE_UNIQUE_IDENTIFIER
StorageDeviceWriteCacheProperty (4)	STORAGE_WRITE_CACHE_PROPERTY
StorageMiniportProperty (5)	STORAGE_MINIPORT_DESCRIPTOR
StorageAccessAlignmentProperty (6)	STORAGE_ACCESS_ALIGNMENT_DESCRIPTOR
StorageDeviceSeekPenaltyProperty (7)	DEVICE_SEEK_PENALTY_DESCRIPTOR
StorageDeviceTrimProperty (8)	DEVICE_TRIM_DESCRIPTOR
StorageDeviceWriteAggregationProperty (9)	DEVICE_WRITE_AGGREGATION_DESCRIPTOR
StorageDeviceLBProvisioningProperty (11)	DEVICE_LB_PROVISIONING_DESCRIPTOR
StorageDevicePowerProperty (12)	DEVICE_POWER_DESCRIPTOR
StorageDeviceCopyOffloadProperty (13)	DEVICE_COPY_OFFLOAD_DESCRIPTOR
StorageDeviceResiliencyProperty (14)	STORAGE_DEVICE_RESILIENCY_DESCRIPTOR

Requirements

Minimum supported client	Windows XP [desktop apps only]
Minimum supported server	Windows Server 2003 [desktop apps only]
Header	WinIoCtl.h (include Windows.h)

Community Additions