2.3.1.3 REGION_INFO

The REGION_INFO structure provides information about a region.

 struct regioninfo {
   LdmObjectId id;
   LdmObjectId diskId;
   LdmObjectId volId;
   LdmObjectId fsId;
   LONGLONG start;
   LONGLONG length;
   REGIONTYPE regionType;
   unsigned long partitionType;
   boolean isActive;
   REGIONSTATUS status;
   hyper lastKnownState;
   LdmObjectId taskId;
   unsigned long rflags;
   unsigned long currentPartitionNumber;
 };
 typedef struct regioninfo REGION_INFO;

id: Specifies the region's OID.

diskId: Specifies the OID of the disk on which the region resides.

volId: Specifies the OID of the volume on the region, if any. The value of this field is nonzero if it is valid.

fsId: Specifies the OID of the file system on the region, if any. The value of this field is nonzero if it is valid.

start: Byte offset of the region on the disk.

length: Length of the region in bytes.

regionType: Value from the REGIONTYPE enumeration that indicates the region type.

partitionType: Type of the partition on the region. This field contains one of the following values.

Value

Meaning

PARTITION_ENTRY_UNUSED

0x00

 An unused entry partition.

PARTITION_EXTENDED

0x05

 An extended partition.

PARTITION_FAT_12

0x01

 A FAT12 file system partition.

PARTITION_FAT_16

0x04

 A FAT16 file system partition.

PARTITION_FAT32

0x0B

 A FAT32 file system partition.

PARTITION_IFS

0x07

 An installable file system (IFS) partition.

PARTITION_LDM

0x42

 An LDM partition.

PARTITION_NTFT

0x80

 A Windows NT operating system fault-tolerant (FT) partition.

VALID_NTFT

0xC0

 A valid Windows NT FT partition.

 The high bit of a partition type code indicates that a partition is part of an NT FT mirror or striped array.

isActive: Boolean value that indicates whether the region is an active partition.

Value

Meaning

FALSE

0

Region is an inactive partition.

TRUE

1

Region is an active partition.

status: Value from the REGIONSTATUS enumeration that indicates the region's status.

lastKnownState: Modification sequence number of the region.

taskId: This LdmObjectId is the task identifier of the associated user request. If no request is made, the value is 0. For more information about this task identifier, see section 2.2.17.

rflags: Bitmap of region flags. The value of this field is generated by combining zero or more of the applicable flags with a logical OR operation.

Value

Meaning

REGION_FORMAT_IN_PROGRESS

0x00000001

Region is currently being formatted.

REGION_IS_SYSTEM_PARTITION

0x00000002

Region contains the system directory. The system directory has the operating system installed to it. This is not necessarily the "active" partition that contains the boot loader file.

REGION_HAS_PAGEFILE

0x00000004

Region contains the paging file.

REGION_HAD_BOOT_INI

0x00000040

Boot file was located in this region when the operating system was last started. This is the "active" partition that contains the boot loader file.

currentPartitionNumber: Number of the partition on the region, if any.