[MS-VDS]: Virtual Disk Service (VDS) Protocol Specification

pack pointer to the pack object that corresponds to the pack the volume belongs to. The serverMUST add the volume object to the list of storage management objects.For each volume plex on the volume, the server MUST create a corresponding volume plex objectand MUST assign it a unique VDS_OBJECT_ID. The server MUST set the volume plex object'svolume pointer to the volume object that was created. The server MUST add the volume plex objectto the list of storage management objects.Finally, for each callback object that is registered in the list of callback objects, the server MUST callthe callback object's IVdsAdviseSink::OnNotify (Opnum 3) method with aVDS_NOTIFICATION structure that has the following attributes:•objectType member is VDS_NTT_VOLUME.•volume member is a VDS_VOLUME_NOTIFICATION that has the following attributes:•ulEvent is VDS_NF_VOLUME_ARRIVE.•volumeId is the VDS_OBJECT_ID of the volume object that was added.•plexId SHOULD be GUID_NULL, but this is not relevant when ulEvent isVDS_NF_VOLUME_ARRIVE.•ulPercentCompleted needs to be from 0 to 100 and is implementation-specific, but it is notrelevant when ulEvent is VDS_NF_VOLUME_ARRIVE.3.4.5.1.6 Removing Volume ObjectsThe server MUST maintain a list of detected volumes. When the server discovers that a volume wasremoved, it MUST remove the corresponding volume object from the list of storage managementobjects.If the volume is a dynamic disk, the server MUST remove the volume plex objects that correspondto the volume's volume plex from the list of storage management objects.For each callback object that is registered in the list of callback objects, the server MUST call thecallback object's IVdsAdviseSink::OnNotify (Opnum 3) method with a VDS_NOTIFICATIONstructure that has the following attributes:•objectType member is VDS_NTT_VOLUME.•The volume member is a VDS_VOLUME_NOTIFICATION that has the following attributes:•ulEvent is VDS_NF_VOLUME_DEPART.•volumeId is the VDS_OBJECT_ID of the volume object that was removed.•plexId SHOULD be GUID_NULL, but it is not relevant when ulEvent isVDS_NF_VOLUME_DEPART.•ulPercentCompleted needs to be from 0-100 and is implementation-specific; however, it isnot relevant when ulEvent is VDS_NF_VOLUME_DEPART.3.4.5.1.7 Adding Virtual Disk ObjectsThe server MUST maintain a list of virtual disks. Virtual disks may be added directly by a client usingthe IVdsVdProvider::AddVDisk (section 3.4.5.2.16.3) method. The server MUST also detect[MS-VDS] — v20110610Virtual Disk Service (VDS) Protocol SpecificationCopyright © 2011 Microsoft Corporation.Release: Friday, June 10, 2011165 / 360