MM_VOLUME_RETURN_MAPPING

Returns VolumeMappingInfo structure that contains within it an array of VolumeMappingElementDef structures that describes all the partition segments that define the specified volume.

Parameters

Parameters to MM_ObjectControl for this operation are as follows:

objectID
The OBID of the file system application to return the volume mapping information.
operation
Set to MM_VOLUME_RETURN_MAPPING.
parameter1
Set to zero.
parameter2
Set to zero.
parameter3
Set to zero.
bufferLength
The number of elements in the VolumeMappingElementDef structures array that the application has made available.
buffer
A pointer to a VolumeMappingInfo structure.

Return Values

The following table lists return values and descriptions.

0x00000000

MM_OK

0x00000008

MM_OBJECT_NOT_FOUND

The file system cannot identify the volume, by the given name, as one under the file system’s responsibility.

0x0000020B

MM_BUFFER_TOO_SMALL

The number of provided array elements was not enough to receive all of the VolumeMappingElementDef structures. If this return value is returned, the file system application will place a value in the numberOfElements field of the VolumeMappingInfo structure indicating the actual number of segments that make up the volume. The calling application then knows how many array elements are required and can retry this operation with the proper adjustments made.

Remarks

The calling application must provide the space for the information returned by the file system application.

bufferlength
The number of elements the buffer can hold.
buffer
Pointer to a structure of VolumeMappingInfo.

The file system application places into the provided array space a set of VolumeMappingElementDef structures that define the partitions segments that make up the capacity of the volume.