IVdsSubSystem interface

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

Provides methods for performing query and configuration operations on a subsystem.

When to implement

Hardware providers implement this interface.

When to use

Applications use the methods of this interface to get the properties, provider, controllers, LUNs, and drives of a subsystem. Applications can also reenumerate subsystem objects, set the controller and subsystem status, create LUNs, and replace drives.

Members

The IVdsSubSystem interface inherits from the IUnknown interface. IVdsSubSystem also has these types of members:

Methods

The IVdsSubSystem interface has these methods.

MethodDescription
CreateLun

Creates a new LUN.

GetDrive

Returns the specified drive.

GetProperties

Returns the properties of the subsystem object.

GetProvider

Returns the provider that manages the subsystem.

QueryControllers

Returns an enumeration of the controllers.

QueryDrives

Returns an enumeration of the drives.

QueryLuns

Returns an enumeration of LUNs surfaced by the subsystem.

QueryMaxLunCreateSize

Returns the size of the maximum LUN that can be created using the specified LUN type and hints.

Reenumerate

Prompts the subsystem to scan its bus to discover newly connected drives or newly disconnected drives.

ReplaceDrive

Replaces or migrates one of the drives with another.

SetControllerStatus

Sets the controllers to either online or offline.

SetStatus

Sets the status of the subsystem to the specified value.

 

Requirements

Minimum supported client

Windows Vista [desktop apps only]

Minimum supported server

Windows Server 2003 [desktop apps only]

Header

Vds.h;
VdsHwPrv.h (for hardware providers)

Library

Uuid.lib

See also

VDS Interfaces
IVdsHwProvider::QuerySubSystems
IVdsController::GetSubSystem
IVdsDrive::GetSubSystem
IVdsLun::GetSubSystem
Subsystem Object

 

 

Show: