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

•Each attached virtual disk object maintains an association with an actual disk (basic, dynamic,or unallocated disk) that has been exposed to the system as a result of attaching the virtualdisk.Each VDS object maintains the following information:VDS Object Identifier: A unique identifier of type VDS_OBJECT_ID.•The server may generate these identifiers at run time.•The server MUST NOT assign two objects to the same identifier.•The server MUST NOT change the identifier for the entire duration of a VDS session or until theobject is removed from the list. A VDS session is defined to be from the point at which a clientreceives a pointer to the service object, to the point at which the client releases all references toit.•The server facilitates ID-based object retrieval.Object Type: A value of type VDS_OBJECT_TYPE, which indicates the type of device that theobject represents.•When a VDS object is created, the server assigns its corresponding object type:•HBA port: VDS_OT_HBAPORT•Initiator adapter: VDS_OT_INIT_ADAPTER•Initiator portal: VDS_OT_INIT_PORTAL•Provider: VDS_OT_PROVIDER•Pack: VDS_OT_PACK•Disk: VDS_OT_DISK•Volume: VDS_OT_VOLUME•Volume plex: VDS_OT_VOLUME_PLEX•Virtual disk: VDS_OT_VDISK•Virtual disk that has been opened: VDS_OT_OPEN_VDISKThe objects can be used by more than one VDS session at a time. Objects can be added or removedas a result of client requests or events that the operating system triggers, such as when a disk is nolonger being reported by its bus, or when the disk's bus reports a new disk.If objects are removed while a client still has references to them, the server MUST return a value ofVDS_E_OBJECT_DELETED (HRESULT of 0x8004240bL) whenever the client attempts to access theobject interface methods.3.4.1.3 Enumeration of ObjectsAll VDS objects that are listed in Storage Management Objects--except for the service object--arereturned by means of enumeration objects. For an example of how these objects are created andused, see section 4.3.[MS-VDS] — v20110610Virtual Disk Service (VDS) Protocol SpecificationCopyright © 2011 Microsoft Corporation.Release: Friday, June 10, 2011157 / 360