Information
The topic you requested is included in another documentation set. For convenience, it's displayed below. Choose Switch to see the topic in its original location.

Controller Object

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

A controller object models a controller in a subsystem. Controllers are contained by subsystems, and each controller has one or more controller ports through which the host computer can write to and read from LUNs. A single controller can be simultaneously set to active for one LUN and inactive for others. A controller that is active for a specified LUN carries the responsibility for handling input to and output from the LUN. The following figure illustrates this idea.

Aa381629.vdscontroller(en-us,VS.85).png

VDS 1.0:  Each of a subsystem's controllers is set to either active or inactive in relation to each of the LUNs the subsystem surfaces.

VDS applications use the IVdsSubSystem::QueryControllers method to determine the controllers that are contained by a specific subsystem. Callers can get a pointer to a specific controller by selecting the desired controller object from the enumeration that is returned by the QueryControllers method. With a controller object, a caller can set the controller status, query for its associated LUNs, query for its controller ports, and flush and invalidate the cache.

In addition to an object identifier, a name, and a serial number, controller object properties include the controller status and health, and a count of the ports.

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

TypeElement
Interfaces that are always exposed by this object IVdsController
Interfaces that are always exposed by this object in VDS 1.1 and 2.0 Fibre Channel providers only IVdsControllerControllerPort
Interfaces that may be exposed by this object IVdsMaintenance
Associated enumerations VDS_CONTROLLER_STATUS.
Associated structures VDS_CONTROLLER_PROP and VDS_CONTROLLER_NOTIFICATION.

 

Related topics

Hardware Provider Objects
IVdsSubSystem::QueryControllers

 

 

Community Additions

Show:
© 2014 Microsoft