LUN Plex Object

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

A LUN plex object models a LUN plex that is contained by a LUN. Only a mirrored LUN can have multiple plexes; all other LUN types have one plex. Each plex contains a copy of the data on the LUN. New plexes can be added to a LUN, and, with the exception of the original plex, existing plexes can be removed. VDS supports four LUN plex types: simple, spanned, striped, and striped with parity. For a description of each of these LUN types, see the LUN Object.

Use the IVdsLun::AddPlex method to add a plex to a LUN and the IVdsLun::RemovePlex method to delete the plex. You can query for LUN plexes by invoking the IVdsLun::QueryPlexes method. You can get a pointer to a specific LUN plex by selecting the desired plex object from the enumeration that is returned by the QueryPlexes method. With a plex object, you can query for the drive extents and automagic hints, and apply new hints.

In addition to an object identifier, a name, and a serial number, LUN plex object properties include the plex type, size, status, health, transition state, and flags; an unmasking list and stripe size; and a rebuild priority setting.

The following table lists related interfaces, enumerations, and structures.

Type Element
Interfaces that are always exposed by this object IVdsLunPlex.
Associated enumerations VDS_LUN_PLEX_FLAG, VDS_LUN_PLEX_STATUS, and VDS_LUN_PLEX_TYPE.
Associated structures VDS_LUN_PLEX_PROP.

 

Hardware Provider Objects

LUN Object