MM_VOLUME_GET_INFO

Returns information relative to the specified existing volume.

Parameters

Parameters to MM_ObjectControl for this operation are as follows:

objectID
The OBID of the file system application to return the volume information.
operation
Set to MM_VOLUME_GET_INFO.
parameter1
Set to zero.
parameter2
Set to zero.
parameter3
Set to zero.
bufferLength
The size, in bytes, of the VolumeInfoDef structure.
buffer
A pointer to a VolumeInfoDef 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.

Remarks

This information is returned in the form of a VolumeInfoDef. Within this structure is a pointer to a VolumeConfigElementList structure allocated by the file system application. (See the MM_VOLUME_RETURN_CONFIG_DIALOG operation.)

An application can present this information to a user for modification. Only those fields in the VolumeConfigElementList structure defined as modifiable, however, can be modified. The token in the VolumeConfigElementList structure must be returned to the file system application by the operations MM_VOLUME_CHANGE_INFO or MM_VOLUME_RETURN_TOKEN.