Share via

3.1.4.1.3 File Systems

  • Article

AddAccessPath: Before invoking AddAccessPath, the client MUST invoke FTEnumVolumes, EnumDiskRegions, or EnumVolumes to retrieve the volume ID. The client MUST pass this returned value as the targetId input parameter to the AddAccessPath. The EnumDiskRegions method returns this value as the REGION_INFO::volId structure member. The FTEnumVolumes and EnumVolumes methods return this parameter as the VOLUME_INFO::id structure members.

DeleteAccessPath: The client MUST use the preceding call sequence description above for AddAccessPath, except that in the final step the client MUST use DeleteAccessPath rather than AddAccessPath.

Format: Before invoking Format, the client MUST invoke FTEnumVolumes, EnumDiskRegions, or EnumVolumes to retrieve the volume ID and the volume's last known state. The client MUST pass these returned values as the storageId and storageLastKnownState input parameters to the Format method. The EnumDiskRegions method returns these values as the REGION_INFO::volId and REGION_INFO::lastKnownState structure members. For volumes on basic disks, the region's lastKnownState is the same as the volume's lastKnownState. The FTEnumVolumes and EnumVolumes methods return these parameters as the VOLUME_INFO::id and VOLUME_INFO::lastKnownState structure members.

Before invoking Format, the client MUST also invoke GetInstalledFileSystems to retrieve the available file system types. The requested file system type, as specified by the FILE_SYSTEM_INFO::fsType input parameter for the call to Format, MUST be one of the types returned by GetInstalledFileSystems. The GetInstalledFileSystems method returns this information as the FILE_SYSTEM_INFO::fsType structure member.

When calling Format, the client MUST initialize the FILE_SYSTEM_INFO::fsType, FILE_SYSTEM_INFO::label, FILE_SYSTEM_INFO::fsflags, and FILE_SYSTEM_INFO::allocationUnitSize fields in the FILE_SYSTEM_INFO structure. The other fields are not used for this call.

GetVolumeMountName: Before invoking GetVolumeMountName, the client MUST invoke FTEnumVolumes, EnumDiskRegions, or EnumVolumes to retrieve the volume ID. The client MUST pass this returned value as the volumeId input parameter to the GetVolumeMountName method. The EnumDiskRegions method returns this value as the REGION_INFO::volId structure member. The FTEnumVolumes and EnumVolumes methods return this parameter as the VOLUME_INFO::id structure members.

EnumAccessPathForVolume:  The client MUST use the preceding call sequence description for GetVolumeMountName, except that in the final step it MUST use EnumAccessPathForVolume rather than GetVolumeMountName.