<div class="content" name="DISK_INFO" uuid="0ddf8059-f404-46a3-9d7e-e3d13c4080e6"><p> </p><p>The DISK_INFO structure provides information about a <span><a href="3c91641b-e5cd-409e-a445-2e4d61ae33c6#gt_c4133b2a-a990-4042-ba44-7fda3090f118" data-linktype="relative-path">disk</a></span>.</p><dl>
<dd>
<div><pre> 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;
</pre></div>
</dd></dl><p><b>id:</b>  Specifies the OID of the disk.</p><p><b>length:</b>   Size of the disk, in
bytes.</p><p><b>freeBytes:</b>  Number of unallocated
bytes on the disk.</p><p><b>bytesPerTrack:</b>  Size of a disk <span><a href="3c91641b-e5cd-409e-a445-2e4d61ae33c6#gt_97ccb480-d025-4a9c-995a-5ead9d3076f9" data-linktype="relative-path">track</a></span>,
in bytes.</p><p><b>bytesPerCylinder:</b>  Size of a disk <span><a href="3c91641b-e5cd-409e-a445-2e4d61ae33c6#gt_cb6bd999-9860-47c5-a5d6-0f267edcaabb" data-linktype="relative-path">cylinder</a></span>,
in bytes.</p><p><b>bytesPerSector:</b>  Size of a disk <span><a href="3c91641b-e5cd-409e-a445-2e4d61ae33c6#gt_b5bbe646-aa5f-4b4e-ae9e-bdae444cbfa2" data-linktype="relative-path">sector</a></span>,
in bytes.</p><p><b>regionCount:</b>  Total number of <span><a href="3c91641b-e5cd-409e-a445-2e4d61ae33c6#gt_6f13fe5f-8747-4ae0-9375-814bf0528197" data-linktype="relative-path">regions</a></span>
on the disk.</p><p><b>dflags:</b>  <span><a href="3c91641b-e5cd-409e-a445-2e4d61ae33c6#gt_e73d1856-ae37-4059-8ffb-1b22002219f1" data-linktype="relative-path">Disk type</a></span> of the
disk.</p><dl>
<dd>
<table><thead>
  <tr>
   <th>
   <p>Value</p>
   </th>
   <th>
   <p>Meaning</p>
   </th>
  </tr>
 </thead><tbody><tr>
  <td>DISK_AUDIO_CD 0x00000001</td>
  <td>Disk is an audio CD.</td>
 </tr><tr>
  <td>DISK_NEC98 0x00000002</td>
  <td>This value is obsolete and MUST NOT be used.</td>
 </tr></tbody></table>
</dd></dl><p><b>deviceType:</b>  Device type of the
disk. This field contains one of the following values.</p><dl>
<dd>
<table><thead>
  <tr>
   <th>
   <p>Value</p>
   </th>
   <th>
   <p>Meaning</p>
   </th>
  </tr>
 </thead><tbody><tr>
  <td>DEVICETYPE_UNKNOWN 0x00000000</td>
  <td>Device is of an unknown type.</td>
 </tr><tr>
  <td>DEVICETYPE_VM 0x00000001</td>
  <td>Device is a dynamic disk.</td>
 </tr><tr>
  <td>DEVICETYPE_REMOVABLE 0x00000002</td>
  <td>Device uses removable media.</td>
 </tr><tr>
  <td>DEVICETYPE_CDROM 0x00000003</td>
  <td>Device is a CD-ROM.</td>
 </tr><tr>
  <td>DEVICETYPE_FDISK 0x00000004</td>
  <td>Device is a basic disk.</td>
 </tr><tr>
  <td>DEVICETYPE_DVD 0x00000005</td>
  <td>Device is a DVD.</td>
 </tr></tbody></table>
</dd></dl><p><b>deviceState:</b>   Device state of the
disk. The value of this field is generated by combining zero or more of the
applicable <span><a href="3c91641b-e5cd-409e-a445-2e4d61ae33c6#gt_425bcab9-7911-4eae-b414-624b7a51eb5f" data-linktype="relative-path">flags</a></span> with a logical
OR operation. Valid combinations are device-type dependent.</p><dl>
<dd>
<table><thead>
  <tr>
   <th>
   <p>Value</p>
   </th>
   <th>
   <p>Meaning</p>
   </th>
  </tr>
 </thead><tbody><tr>
  <td>DEVICESTATE_UNKNOWN 0x00000000</td>
  <td>Disk is in an unknown state.</td>
 </tr><tr>
  <td>DEVICESTATE_HEALTHY 0x00000001</td>
  <td>Disk is fully functional.</td>
 </tr><tr>
  <td>DEVICESTATE_NO_MEDIA 0x00000002</td>
  <td>Disk has no media.</td>
 </tr><tr>
  <td>DEVICESTATE_NOSIG 0x00000004</td>
  <td>Disk has an invalid signature.</td>
 </tr><tr>
  <td>DEVICESTATE_BAD 0x00000008</td>
  <td>Disk was deleted or experienced an install or hardware problem.</td>
 </tr><tr>
  <td>DEVICESTATE_NOT_READY 0x00000010</td>
  <td>Disk is not ready yet.</td>
 </tr><tr>
  <td>DEVICESTATE_MISSING 0x00000020</td>
  <td>Disk is no longer available.</td>
 </tr><tr>
  <td>DEVICESTATE_OFFLINE 0x00000040</td>
  <td>Disk is offline.</td>
 </tr><tr>
  <td>DEVICESTATE_FAILING 0x00000080</td>
  <td>Disk experienced a physical I/O error.</td>
 </tr><tr>
  <td>DEVICESTATE_IMPORT_FAILED 0x00000100</td>
  <td>Disk belongs to a group whose import failed.</td>
 </tr><tr>
  <td>DEVICESTATE_UNCLAIMED 0x00000200</td>
  <td>Disk belongs to a foreign disk group.</td>
 </tr></tbody></table>
</dd></dl><p><b>busType:</b>  Type of <span><a href="3c91641b-e5cd-409e-a445-2e4d61ae33c6#gt_36805c8d-5505-4906-986b-8b08a4f0741e" data-linktype="relative-path">bus</a></span>
on which the disk resides. This field contains one of the following values.</p><dl>
<dd>
<table><thead>
  <tr>
   <th>
   <p>Value</p>
   </th>
   <th>
   <p>Meaning</p>
   </th>
  </tr>
 </thead><tbody><tr>
  <td>BUSTYPE_UNKNOWN 0x00000000</td>
  <td>Bus type is unknown.</td>
 </tr><tr>
  <td>BUSTYPE_IDE 0x00000001</td>
  <td>Disk resides on an Integrated Drive Electronics (IDE) bus.</td>
 </tr><tr>
  <td>BUSTYPE_SCSI 0x00000002</td>
  <td>Disk resides on a SCSI bus.</td>
 </tr><tr>
  <td>BUSTYPE_FIBRE 0x00000003</td>
  <td>Disk resides on a fiber channel bus.</td>
 </tr><tr>
  <td>BUSTYPE_USB 0x00000004</td>
  <td>Disk resides on a universal serial bus (USB).</td>
 </tr><tr>
  <td>BUSTYPE_SSA 0x00000005</td>
  <td>Disk resides on a serial storage architecture (SSA) Bus.</td>
 </tr><tr>
  <td>BUSTYPE_1394 0x00000006</td>
  <td>Disk resides on an Institute of Electronics and Electrical Engineers (IEEE) 1394 bus.</td>
 </tr></tbody></table>
</dd></dl><p><b>attributes:</b>  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.</p><dl>
<dd>
<table><thead>
  <tr>
   <th>
   <p>Value</p>
   </th>
   <th>
   <p>Meaning</p>
   </th>
  </tr>
 </thead><tbody><tr>
  <td>DEVICEATTR_NONE 0x00000000</td>
  <td>Disk has no attributes.</td>
 </tr><tr>
  <td>DEVICEATTR_RDONLY 0x00000001</td>
  <td>Disk is read-only.</td>
 </tr><tr>
  <td>DEVICEATTR_NTMS 0x00000002</td>
  <td>This value is obsolete.</td>
 </tr></tbody></table>
</dd></dl><p><b>isUpgradeable:</b>  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.</p><dl>
<dd>
<table><thead>
  <tr>
   <th>
   <p>Value</p>
   </th>
   <th>
   <p>Meaning</p>
   </th>
  </tr>
 </thead><tbody><tr>
  <td>FALSE 0</td>
  <td>Disk cannot be converted to a dynamic disk.</td>
 </tr><tr>
  <td>TRUE 1</td>
  <td>Disk can be encapsulated or converted to a dynamic disk.</td>
 </tr></tbody></table>
</dd></dl><p><b>portNumber:</b>  <span><a href="3c91641b-e5cd-409e-a445-2e4d61ae33c6#gt_9e1126a3-da48-4fd8-aafa-17b25c8818f5" data-linktype="relative-path">SCSI port
number</a></span> of the disk, if the bus reports this information.</p><p><b>targetNumber:</b>  SCSI target
identifier of the disk, if the bus reports this information.</p><p><b>lunNumber:</b>  <span><a href="3c91641b-e5cd-409e-a445-2e4d61ae33c6#gt_17a307c8-d4b9-4a78-bf01-a1b5a2da11db" data-linktype="relative-path">SCSI
logical unit number (LUN)</a></span> of the disk, if the bus reports this
information.</p><p><b>lastKnownState:</b>  <span><a href="3c91641b-e5cd-409e-a445-2e4d61ae33c6#gt_5a574d80-6bdb-4fb0-a0dd-b0601d16b4cd" data-linktype="relative-path">Modification
sequence number</a></span> of the disk.</p><p><b>taskId:</b>  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 <span><a href="d55c167e-c6ad-445f-951c-9ac2d0de7a11" data-linktype="relative-path">2.2.17</a></span>.</p><p><b>cchName:</b>  Length of the <span><a href="3c91641b-e5cd-409e-a445-2e4d61ae33c6#gt_c6421d9a-1a20-4ef1-983b-5d4208d8e473" data-linktype="relative-path">hard disk
physical name</a></span>, in <span><a href="3c91641b-e5cd-409e-a445-2e4d61ae33c6#gt_c305d0ab-8b94-461a-bd76-13b40cb8c4d8" data-linktype="relative-path">Unicode</a></span> characters,
including the terminating null character.</p><p><b>cchVendor:</b>  Length of the disk&#39;s
vendor name, in Unicode characters, including the terminating null character.</p><p><b>cchDgid:</b>  Length of the disk&#39;s group
identification handle, in <span><a href="3c91641b-e5cd-409e-a445-2e4d61ae33c6#gt_79fa85ca-ac61-467c-b819-e97dc1a7a599" data-linktype="relative-path">ASCII</a></span> characters,
including the terminating null character.</p><p><b>cchAdapterName:</b>  Length of the
disk&#39;s adapter name, in Unicode characters, including the terminating null
character.</p><p><b>cchDgName:</b>  Length of the disk&#39;s group
name, in Unicode characters, including the terminating null character.</p><p><b>name:</b>  Null-terminated physical
device name of the hard disk, in the format &#39;\device\Harddisk1&#39;. This is
Unicode.</p><p><b>vendor:</b>  Null-terminated name of the
hard disk vendor. This is the disk vendor&#39;s disk model name. This is Unicode.</p><p><b>dgid:</b>  Specifies the object
identifier of the disk&#39;s disk group. This is ASCII.</p><p><b>adapterName:</b>  Null-terminated name
of the <span><a href="3c91641b-e5cd-409e-a445-2e4d61ae33c6#gt_13bf93c4-ba9e-4e36-a915-4a238b3da763" data-linktype="relative-path">disk adapter</a></span> as
returned by the disk adapter firmware; for example, &#39;Adaptec AHA-2940U2W -
Ultra2 SCSI&#39;. This is Unicode.</p><p><b>dgName:</b>  Null-terminated name for
the disk&#39;s disk group, if the disk is dynamic. Only dynamic disks have an
associated disk group. Basic disks do not. This is Unicode.</p></div>