Export (0) Print
Expand All
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


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.

ValueMeaning
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.

ValueMeaning
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.

ValuelpOutBuffer 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)

See also

Disk Management Structures
IOCTL_STORAGE_QUERY_PROPERTY
STORAGE_DESCRIPTOR_HEADER
STORAGE_QUERY_TYPE
STORAGE_DEVICE_DESCRIPTOR
STORAGE_ADAPTER_DESCRIPTOR
STORAGE_PROPERTY_ID

 

 

Did you find this helpful?
(1500 characters remaining)
Thank you for your feedback

Community Additions

ADD
Show:
© 2014 Microsoft. All rights reserved.