VDS_CONTROLLER_PROP structure (vds.h)

Article
02/22/2024

[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 controller object.

Syntax

typedef struct _VDS_CONTROLLER_PROP {
  VDS_OBJECT_ID         id;
  LPWSTR                pwszFriendlyName;
  LPWSTR                pwszIdentification;
  VDS_CONTROLLER_STATUS status;
  VDS_HEALTH            health;
  SHORT                 sNumberOfPorts;
} VDS_CONTROLLER_PROP, *PVDS_CONTROLLER_PROP;

Members

id

The GUID of the controller object.

pwszFriendlyName

The name of the controller; a zero-terminated, human-readable string.

pwszIdentification

The subsystem identifier, typically a serial number; a zero-terminated, human-readable string.

status

A VDS_CONTROLLER_STATUS enumeration value that specifies the status of the controller.

health

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

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

VDS_H_UNKNOWN (0)

VDS_H_HEALTHY (1)

VDS_H_FAILED (8)

VDS_H_REPLACED (9)

VDS_H_DEGRADED (11)

sNumberOfPorts

The number of ports that the controller contains. Ports are numbered from zero. Hardware providers should set this member to zero for PCI RAID cards.

Remarks

The IVdsController::GetProperties method returns this structure to report the properties of a controller object.

Requirements

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