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

For a VDS_DISK_EXTENT or VDS_DISK_FREE_EXTENT that describes a disk extent, a clientmaps the extent to its disk by obtaining a list of VDS_DISK_PROP or VDS_DISK_PROP2structures. The client obtains this list by invoking IVdsPack::QueryDisks followed byIVdsDisk::GetProperties or IVdsDisk3::GetProperties2 for each disk. The server returns aVDS_DISK_PROP structure from IVdsDisk::GetProperties or a VDS_DISK_PROP2 structurefrom IVdsDisk3::GetProperties2. The client matches the VDS_DISK_EXTENT::diskId orVDS_DISK_FREE_EXTENT::diskId member to the VDS_DISK_PROP::id orVDS_DISK_PROP2::id member.Disks and Partitions: The client invokes IUnknown::QueryInterface to obtain theIVdsAdvancedDisk interface. The client invokes IVdsAdvancedDisk::QueryPartitions to obtaina list of the partitions for a specified disk. The server returns a list of VDS_PARTITION_PROPstructures, one for each partition on the disk.Extents and Volumes: For a VDS_DISK_EXTENT that describes a disk extent, a client maps theextent to its volume by obtaining a list of VDS_VOLUME_PROP structures. The client obtains thislist by invoking IVdsPack::QueryVolumes, followed by IVdsVolume::GetProperties orIVdsVolume2::GetProperties2 for each volume. The server returns a VDS_VOLUME_PROPstructure from IVdsVolume::GetProperties or a VDS_VOLUME_PROP2 structure fromIVdsVolume2::GetProperties2. The client matches the VDS_DISK_EXTENT::volumeIdmember to the VDS_VOLUME_PROP::id or VDS_VOLUME_PROP2::id member.Extents and Plexes: For a VDS_DISK_EXTENT that describes a disk extent, a client maps theextent to its volume plex by obtaining a list of VDS_VOLUME_PLEX_PROP structures. The clientobtains this list by invoking IVdsVolume::QueryPlexes, followed byIVdsVolumePlex::GetProperties for each plex. The server returns aVDS_VOLUME_PLEX_PROP structure from IVdsVolumePlex::GetProperties orIVdsVolume2::GetProperties2. The client matches the VDS_DISK_EXTENT::plexId member tothe VDS_VOLUME_PLEX_PROP::id member.Volumes and File Systems: For a VDS_FILE_SYSTEM_PROP structure that describes a file system,a client maps the file system to a volume by obtaining a list of VDS_VOLUME_PROP structures.The client invokes IVdsPack::QueryVolumes, followed by IVdsVolume::GetProperties for eachvolume. The server returns a VDS_VOLUME_PROP structure from IVdsVolume::GetPropertiesor IVdsVolume2::GetProperties2. The client matches theVDS_FILE_SYSTEM_PROP::volumeId member to the VDS_VOLUME_PROP::id orVDS_VOLUME_PROP2::id member.Volumes and Drive Letters: For a VDS_DRIVE_LETTER_PROP structure that describes a driveletter, a client maps the drive letter to a volume by obtaining a list of VDS_VOLUME_PROPstructures. The client invokes IVdsPack::QueryVolumes, followed byIVdsVolume::GetProperties or IVdsVolume2::GetProperties2 for each volume. The serverreturns a VDS_VOLUME_PROP structure from IVdsVolume::GetProperties or aVDS_VOLUME_PROP2 structure from IVdsVolume2::GetProperties2. The client matches theVDS_DRIVE_LETTER_PROP::volumeId member to the VDS_VOLUME_PROP::id orVDS_VOLUME_PROP2::id member.3.2.1.2 Service and ProvidersIVdsService::GetObject: "XXX" is a placeholder for provider, pack, disk, virtual disk, volume,volume plex, or HBA port. Prior to invoking GetObject, the client invokes QueryXXXs on interfacesthat have a QueryXXXs method. The server responds with an IEnumVdsObject interface, whichenumerates a list of IUnknown interfaces, one for each object that is associated with theenumeration. The client invokes IUnknown::QueryInterface to retrieve an IVdsXXX interface onthe object. The client invokes IVdsXXX::GetProperties to retrieve the object ID. The client passes[MS-VDS] — v20110610Virtual Disk Service (VDS) Protocol SpecificationCopyright © 2011 Microsoft Corporation.Release: Friday, June 10, 2011146 / 360