 Important: |
|---|
| This is retired content. This content is outdated and is no longer being maintained. It is provided as a courtesy for individuals who are still using these technologies. This content may contain URLs that were valid when originally published, but now link to sites or pages that no longer exist. |
Block device drivers respond to this I/O control code to return disk information.
Parameters
- hDevice
- Handle to the block device.
- dwIoControlCode
- Specifies this code.
- lpInBuffer
- Pointer to a DISK_INFOstructure
- nInBufferSize
- Specifies the size of the DISK_INFOstructure.
- lpOutBuffer
- Not used.
- nOutBufferSize
- Not used.
- lpBytesReturned
- Pointer to a DWORDto receive total number of bytes returned.
- lpOverlapped
- Not used.
Remarks
On return, the DISK_INFOstructure parameters must be filled in with the following information:
- di_total_sectors
- Total number of blocks on the device
- di_bytes_per_sector
- Size of a block, in bytes. Values other than 512 are currently not supported.
- di_cylinders
- If the device supports cylinder/head/sector (CHS) addressing, the driver may report the number of cylinders here. However, the FAT file system does not depend on this information.
- di_heads
- If the device supports CHS addressing, the driver may report the number of heads per cylinder here. However, the FAT file system does not depend on this information.
- di_sectors
- If the device supports CHS addressing, the driver may report the number of sectors per track here. However, the FAT file system does not depend on this information.
- di_flags
- Contains zero or more of the following:
Value Description DISK_INFO_FLAG_MBR The device has or needs a master boot record. DISK_INFO_FLAG_CHS_UNCERTAIN The device does not support CHS addressing; values for di_cylinders, di_heads, and/or di_sectorsmay be simulated, estimated, or not provided. DISK_INFO_FLAG_UNFORMATTED The device requires a low-level format; the FAT file system currently ignores this flag. DISK_INFO_FLAG_PAGEABLE The device supports demand paging; read and write requests are synchronous and do not involve any memory manager calls, loader operations, or thread switches. In Windows CE versions prior to 3.0, this code was called DISK_IOCTL_GETINFO.
Requirements
Runs on Versions Defined in Include Link to Windows CE OS 3.0 and later Note This API is part of the complete Windows CE OS package as provided by Microsoft. The functionality of a particular platform is determined by the original equipment manufacturer (OEM) and some devices may not support this API.
Last updated on Tuesday, July 13, 2004