VDS_DRIVE_PROP structure (vds.h)

Article
02/09/2023

[Beginning with Windows 8 and Windows Server 2012, the Virtual Disk Service COM interface is superseded by the Windows Storage Management API.]

Defines the properties of a drive object.

Syntax

typedef struct _VDS_DRIVE_PROP {
  VDS_OBJECT_ID    id;
  ULONGLONG        ullSize;
  LPWSTR           pwszFriendlyName;
  LPWSTR           pwszIdentification;
  ULONG            ulFlags;
  VDS_DRIVE_STATUS status;
  VDS_HEALTH       health;
  SHORT            sInternalBusNumber;
  SHORT            sSlotNumber;
} VDS_DRIVE_PROP, *PVDS_DRIVE_PROP;

Members

id

The GUID of the drive object.

ullSize

The size of the drive, in bytes.

pwszFriendlyName

A NULL-terminated wide-character string that contains the name of the drive.

pwszIdentification

A NULL-terminated wide-character string that contains the drive identifier.

ulFlags

A bitmask of
VDS_DRIVE_FLAG enumeration values.

status

A
VDS_DRIVE_STATUS enumeration value that specifies the status of the drive.

health

A VDS_HEALTH enumeration value that specifies the health status of the drive. The following are the valid values for this member.

Windows Server 2008, Windows Vista and Windows Server 2003: VDS_H_REPLACED and VDS_H_PENDING_FAILURE are not supported.

VDS_H_UNKNOWN (0)

VDS_H_HEALTHY (1)

VDS_H_FAILED (8)

VDS_H_REPLACED (9)

VDS_H_PENDING_FAILURE (10)

sInternalBusNumber

The number of the bus to which the drive is connected. This number is an implementer-assigned value that uniquely identifies the bus within the subsystem. It is not constrained by the number of buses that the subsystem contains, and it is not related to the value of the sNumberOfInternalBuses member of the VDS_SUB_SYSTEM_PROP structure.

sSlotNumber

The number of the slot that the drive occupies. This number is an implementer-assigned value that uniquely identifies the slot within the bus. It is not constrained by the number of slots that the bus contains, and it is not related to the value of the sMaxNumberOfSlotsEachBus member of the VDS_SUB_SYSTEM_PROP structure.

Remarks

The IVdsDrive::GetProperties method returns this structure to report the properties of a drive object.

Requirements

Requirement	Value
Minimum supported client	Windows Vista [desktop apps only]
Minimum supported server	Windows Server 2003 [desktop apps only]
Header	vds.h