The DISK_INFO structure provides information about a disk.
struct diskinfo {
LdmObjectId id;
LONGLONG length;
LONGLONG freeBytes;
unsigned long bytesPerTrack;
unsigned long bytesPerCylinder;
unsigned long bytesPerSector;
unsigned long regionCount;
unsigned long dflags;
unsigned long deviceType;
unsigned long deviceState;
unsigned long busType;
unsigned long attributes;
boolean isUpgradeable;
int portNumber;
int targetNumber;
int lunNumber;
LONGLONG lastKnownState;
LdmObjectId taskId;
int cchName;
int cchVendor;
int cchDgid;
int cchAdapterName;
int cchDgName;
[size_is(cchName)] wchar_t* name;
[size_is(cchVendor)] wchar_t* vendor;
[size_is(cchDgid)] byte* dgid;
[size_is(cchAdapterName)] wchar_t* adapterName;
[size_is(cchDgName)] wchar_t* dgName;
};
typedef struct diskinfo DISK_INFO;
id: Specifies the OID of the disk.
length: Size of the disk, in bytes.
freeBytes: Number of unallocated bytes on the disk.
bytesPerTrack: Size of a disk track, in bytes.
bytesPerCylinder: Size of a disk cylinder, in bytes.
bytesPerSector: Size of a disk sector, in bytes.
regionCount: Total number of regions on the disk.
dflags: Disk type of the disk.
|
Value |
Meaning |
|---|---|
|
DISK_AUDIO_CD 0x00000001 |
Disk is an audio CD. |
|
DISK_NEC98 0x00000002 |
This value is obsolete and MUST NOT be used. |
deviceType: Device type of the disk. This field contains one of the following values.
|
Value |
Meaning |
|---|---|
|
DEVICETYPE_UNKNOWN 0x00000000 |
Device is of an unknown type. |
|
DEVICETYPE_VM 0x00000001 |
Device is a dynamic disk. |
|
DEVICETYPE_REMOVABLE 0x00000002 |
Device uses removable media. |
|
DEVICETYPE_CDROM 0x00000003 |
Device is a CD-ROM. |
|
DEVICETYPE_FDISK 0x00000004 |
Device is a basic disk. |
|
DEVICETYPE_DVD 0x00000005 |
Device is a DVD. |
deviceState: Device state of the disk. The value of this field is generated by combining zero or more of the applicable flags with a logical OR operation. Valid combinations are device-type dependent.
|
Value |
Meaning |
|---|---|
|
DEVICESTATE_UNKNOWN 0x00000000 |
Disk is in an unknown state. |
|
DEVICESTATE_HEALTHY 0x00000001 |
Disk is fully functional. |
|
DEVICESTATE_NO_MEDIA 0x00000002 |
Disk has no media. |
|
DEVICESTATE_NOSIG 0x00000004 |
Disk has an invalid signature. |
|
DEVICESTATE_BAD 0x00000008 |
Disk was deleted or experienced an install or hardware problem. |
|
DEVICESTATE_NOT_READY 0x00000010 |
Disk is not ready yet. |
|
DEVICESTATE_MISSING 0x00000020 |
Disk is no longer available. |
|
DEVICESTATE_OFFLINE 0x00000040 |
Disk is offline. |
|
DEVICESTATE_FAILING 0x00000080 |
Disk experienced a physical I/O error. |
|
DEVICESTATE_IMPORT_FAILED 0x00000100 |
Disk belongs to a group whose import failed. |
|
DEVICESTATE_UNCLAIMED 0x00000200 |
Disk belongs to a foreign disk group. |
busType: Type of bus on which the disk resides. This field contains one of the following values.
|
Value |
Meaning |
|---|---|
|
BUSTYPE_UNKNOWN 0x00000000 |
Bus type is unknown. |
|
BUSTYPE_IDE 0x00000001 |
Disk resides on an Integrated Drive Electronics (IDE) bus. |
|
BUSTYPE_SCSI 0x00000002 |
Disk resides on a SCSI bus. |
|
BUSTYPE_FIBRE 0x00000003 |
Disk resides on a fiber channel bus. |
|
BUSTYPE_USB 0x00000004 |
Disk resides on a universal serial bus (USB). |
|
BUSTYPE_SSA 0x00000005 |
Disk resides on a serial storage architecture (SSA) Bus. |
|
BUSTYPE_1394 0x00000006 |
Disk resides on an Institute of Electronics and Electrical Engineers (IEEE) 1394 bus. |
attributes: Bitmap of disk attributes. The value of this field is generated by combining zero or more of the applicable flags defined in the following table with a logical OR operation.
|
Value |
Meaning |
|---|---|
|
DEVICEATTR_NONE 0x00000000 |
Disk has no attributes. |
|
DEVICEATTR_RDONLY 0x00000001 |
Disk is read-only. |
|
DEVICEATTR_NTMS 0x00000002 |
This value is obsolete. |
isUpgradeable: Boolean value that indicates whether the disk can be converted to a dynamic disk. Will be true if the disk is basic, healthy, and has 512 byte sectors.
|
Value |
Meaning |
|---|---|
|
FALSE 0 |
Disk cannot be converted to a dynamic disk. |
|
TRUE 1 |
Disk can be encapsulated or converted to a dynamic disk. |
portNumber: SCSI port number of the disk, if the bus reports this information.
targetNumber: SCSI target identifier of the disk, if the bus reports this information.
lunNumber: SCSI logical unit number (LUN) of the disk, if the bus reports this information.
lastKnownState: Modification sequence number of the disk.
taskId: 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.
cchName: Length of the hard disk physical name, in Unicode characters, including the terminating null character.
cchVendor: Length of the disk's vendor name, in Unicode characters, including the terminating null character.
cchDgid: Length of the disk's group identification handle, in ASCII characters, including the terminating null character.
cchAdapterName: Length of the disk's adapter name, in Unicode characters, including the terminating null character.
cchDgName: Length of the disk's group name, in Unicode characters, including the terminating null character.
name: Null-terminated physical device name of the hard disk, in the format '\device\Harddisk1'. This is Unicode.
vendor: Null-terminated name of the hard disk vendor. This is the disk vendor's disk model name. This is Unicode.
dgid: Specifies the object identifier of the disk's disk group. This is ASCII.
adapterName: Null-terminated name of the disk adapter as returned by the disk adapter firmware; for example, 'Adaptec AHA-2940U2W - Ultra2 SCSI'. This is Unicode.
dgName: Null-terminated name for the disk's disk group, if the disk is dynamic. Only dynamic disks have an associated disk group. Basic disks do not. This is Unicode.