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.

VDS_CONTROLLER_NOTIFICATION structure

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

Defines the details of controller events.

Syntax


typedef struct _VDS_CONTROLLER_NOTIFICATION {
  ULONG         ulEvent;
  VDS_OBJECT_ID controllerId;
} VDS_CONTROLLER_NOTIFICATION;

Members

ulEvent

Determines the controller event for which an application will be notified, as one of the following values.

ValueMeaning
VDS_NF_CONTROLLER_ARRIVE
103

A controller is reported as physically present on the subsystem. The VDS_CONTROLLER_STATUS value associated with this notification should be any value except VDS_CS_REMOVED.

VDS_NF_CONTROLLER_DEPART
104

A controller was physically removed from the subsystem. The VDS_CONTROLLER_STATUS value should be VDS_CS_UNKNOWN or VDS_CS_REMOVED.

VDS_NF_CONTROLLER_MODIFY
350

A member of the VDS_CONTROLLER_PROP structure changed.

Windows Server 2008, Windows Vista and Windows Server 2003:  This value is not supported.

VDS_NF_CONTROLLER_REMOVED
351

A controller is physically present but not available for use. The VDS_CONTROLLER_STATUS value should be VDS_CS_FAILED (removed from use because of failure), VDS_CS_ONLINE (not failed, but not in use either), VDS_CS_NOT_READY, or VDS_CS_UNKNOWN.

Windows Server 2008, Windows Vista and Windows Server 2003:  This value is not supported.

 

controllerId

The GUID of the controller that triggered the event.

Remarks

The VDS_NOTIFICATION structure includes this structure as a member.

An application can receive controller events by implementing the IVdsAdviseSink interface and passing the interface pointer as an argument to the IVdsService::Advise method.

To get the controller object, use the IVdsService::GetObject method. You can then use the IVdsController::GetProperties method to get the controller properties.

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)

See also

VDS Structures
VDS_NOTIFICATION
IVdsAdviseSink
IVdsService::Advise
IVdsController

 

 

Show: