VDS_CONTROLLER_NOTIFICATION structure (vds.h)
[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.
| Value | Meaning |
|---|---|
|
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. |
|
A controller was physically removed from the subsystem. The VDS_CONTROLLER_STATUS value should be VDS_CS_UNKNOWN or VDS_CS_REMOVED. |
|
A member of the VDS_CONTROLLER_PROP structure changed.
Windows Server 2008, Windows Vista and Windows Server 2003: This value is not supported. |
|
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
| Requirement | Value |
|---|---|
| Minimum supported client | Windows Vista [desktop apps only] |
| Minimum supported server | Windows Server 2003 [desktop apps only] |
| Header | vds.h |