Share via

3.1.4.1.5 Partitions

  • Article

CreatePartition:  Before invoking CreatePartition, the client MUST invoke EnumDiskRegions to retrieve the region ID, the disk ID, and the region's last known state. The client MUST pass these returned values as the REGION_SPEC structure's regionId, diskId, and lastKnownState members in the input parameter to the CreatePartition method. These values are returned by EnumDiskRegions as REGION_INFO::id, REGION_INFO::diskId, and REGION_INFO::lastKnownState.

CreatePartitionAssignAndFormat:  For call sequencing related to the REGION_SPEC input parameter, see section 3.2.4.4.1.3. For call sequencing related to the letterLastKnownState input parameter, see section 3.2.4.4.1.19. For call sequencing related to the FILE_SYSTEM_INFO::fsType input parameter, see section 3.2.4.4.1.23.

CreatePartitionAssignAndFormatEx:  For call sequencing related to the REGION_SPEC input parameter, see CreatePartition. For call sequencing related to the letterLastKnownState input parameter, see section 3.2.4.4.1.19. For call sequencing related to the FILE_SYSTEM_INFO::fsType input parameter, see section 3.2.4.4.1.23.

When calling CreatePartitionAssignAndFormatEx, 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.

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

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

MarkActivePartition:  Before invoking MarkActivePartition, the client MUST invoke EnumDiskRegions to retrieve the region id and the region's last known state. The client MUST pass these returned values as the regionId and regionLastKnownState input parameters to the MarkActivePartition method. The EnumDiskRegions method returns these values as the REGION_INFO::id and REGION_INFO::lastKnownState structure members.