VDS_SUB_SYSTEM_PROP2 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 subsystem object. This structure is identical to the VDS_SUB_SYSTEM_PROP structure, except that it includes the supported RAID types and number of enclosures as members.

Syntax

typedef struct _VDS_SUB_SYSTEM_PROP2 {
  VDS_OBJECT_ID         id;
  LPWSTR                pwszFriendlyName;
  LPWSTR                pwszIdentification;
  ULONG                 ulFlags;
  ULONG                 ulStripeSizeFlags;
  ULONG                 ulSupportedRaidTypeFlags;
  VDS_SUB_SYSTEM_STATUS status;
  VDS_HEALTH            health;
  SHORT                 sNumberOfInternalBuses;
  SHORT                 sMaxNumberOfSlotsEachBus;
  SHORT                 sMaxNumberOfControllers;
  SHORT                 sRebuildPriority;
  ULONG                 ulNumberOfEnclosures;
} VDS_SUB_SYSTEM_PROP2, *PVDS_SUB_SYSTEM_PROP2;

Members

id

The GUID of the subsystem object.

pwszFriendlyName

A pointer to a NULL-terminated wide-character string containing the name of the subsystem, typically a brand name and a model name.

pwszIdentification

A pointer to a NULL-terminated wide-character string containing a combination of the disk array's serial number and the subsystem identifier.

ulFlags

A bitmask of one or more
VDS_SUB_SYSTEM_FLAG enumeration values.

ulStripeSizeFlags

The set of stripe sizes supported by a provider for striped volumes and/or LUNs. A stripe size must be a power of 2. Each bit in the 32-bit integer represents a size, in bytes. For example, if the nth bit is set, then VDS supports stripe size of 2^n. Thus, bits 0 through 31 can specify 2^0 through 2^31.

ulSupportedRaidTypeFlags

A bitmask of VDS_SUB_SYSTEM_SUPPORTED_RAID_TYPE_FLAG enumeration values specifying the RAID levels that the subsystem supports. The default value for this member is zero. A value of zero means that no RAID levels are supported.

status

A VDS_SUB_SYSTEM_STATUS enumeration value that specifies the status of the subsystem object.

health

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

VDS_H_UNKNOWN (0)

VDS_H_HEALTHY (1)

VDS_H_FAILED (8)

VDS_H_DEGRADED (11)

sNumberOfInternalBuses

The number of buses (or "channels") that the subsystem contains.

sMaxNumberOfSlotsEachBus

The maximum number of slots that each of the buses can include. Each slot can accommodate one drive. The subsystem model assumes that each bus has the same maximum number of slots.

sMaxNumberOfControllers

The maximum number of controllers that the subsystem can contain.

sRebuildPriority

The rebuild priority of the LUNs that belong to the subsystem. This value can range from 0 (lowest priority) through 15 (highest priority).

ulNumberOfEnclosures

The number of enclosures in the subsystem. The default value for this member is zero. A value of zero indicates that this property is not available for this subsystem.

Remarks

The IVdsSubSystem2::GetProperties2 method returns this structure to report the properties of a subsystem object.

Requirements

Requirement	Value
Minimum supported client	Windows 7 [desktop apps only]
Minimum supported server	Windows Server 2008 R2 [desktop apps only]
Header	vds.h