MM_POOL_RETURN_MAPPING
Returns the logical partition associated with a pool (see Pools).
Parameters to MM_ObjectControl for this operation are as follows:
The following table lists return values and descriptions.
0x00000000 |
MM_OK |
0x00000008 |
MM_OBJECT_NOT_FOUND The file system cannot identify the pool, 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. |
If the pool consists of multiple elements, MM_POOL_RETURN_MAPPING returns the list of all the elements that go into the pool.
NOTE:If the pool contains multiple elements, none of these elements is the logical partition associated with the pool. There is one child object that all of these elements point to that is the logical partition for the pool.
The calling application must provide the space for the information returned by the file system application.
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 pool.