Edit

VDS_PORT_NOTIFICATION structure (vdshwprv.h)

  • Article

[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 port events.

Syntax

typedef struct _VDS_PORT_NOTIFICATION {
  ULONG         ulEvent;
  VDS_OBJECT_ID portId;
} VDS_PORT_NOTIFICATION;

Members

ulEvent

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

Value Meaning
VDS_NF_PORT_ARRIVE
121
 A controller port is reported as physically present on the subsystem. The VDS_PORT_STATUS value associated with this notification should be any value except VDS_PRS_REMOVED.
VDS_NF_PORT_DEPART
122
 A controller, and therefore its port, were physically unplugged from the subsystem. The VDS_PORT_STATUS value should be VDS_PRS_UNKNOWN or VDS_PRS_REMOVED.
VDS_NF_PORT_MODIFY
352
 A member of the VDS_PORT_PROP structure changed.

Windows Server 2008, Windows Vista and Windows Server 2003 R2:  This value is not supported.
VDS_NF_PORT_REMOVED
353
 A controller port is physically present but not available for use. For example, either the controller or the port itself is set to inactive. The VDS_PORT_STATUS value should be VDS_PRS_FAILED (removed from use because of failure), VDS_PRS_OFFLINE (not failed, but not in use either), VDS_PRS_NOT_READY, or VDS_PRS_UNKNOWN.

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

portId

The VDS_OBJECT_ID of the controller port that triggered the event.

Remarks

The VDS_NOTIFICATION structure includes this structure as a member.

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

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

Requirements

Requirement Value
Minimum supported client Windows Vista [desktop apps only]
Minimum supported server Windows Server 2003 R2 [desktop apps only]
Header vdshwprv.h
Redistributable VDS 1.1

See also

IVdsAdviseSink

IVdsControllerPort

IVdsService::Advise

VDS Structures

VDS_NOTIFICATION