Important Notice

The pages on this site contain documentation for very old MS-DOS software, purely for historical purposes. If you're looking for up-to-date documentation, particularly for programming, you should not rely on the information found here, as it will be woefully out of date.

                                                      ◄Up► ◄Next► ◄Previous►
────────────────────────────────────────────────────────────────────────────
 
#define INCL_DOSDEVIOCTL
 
typedef struct _TRACKFORMAT {    /* trckfmt */
    BYTE bCommand;
    USHORT usHead;
    USHORT usCylinder;
    USHORT usReserved;
    USHORT cSectors;
    struct {
        BYTE bCylinder;
        BYTE bHead;
        BYTE idSector;
        BYTE bBytesSector;
    } FormatTable[1];
} TRACKFORMAT;
 
The TRACKFORMAT structure contains information about the disk drive.
 
Field           Description
────────────────────────────────────────────────────────────────────────────
 
bCommand        Specifies the type of track layout. If this field is 0x0000,
                the track layout contains nonconsecutive sectors or does not
                start with sector 1. If it is 0x0001, the track layout
                starts with sector 1 and contains only consecutive sectors.
 
usHead          Specifies the number of the physical head on which to
                perform the operation.
 
usCylinder      Specifies the cylinder number for the operation.
 
cSectors        Specifies the number of sectors on the track being
                formatted.
 
FormatTable[1]  Specifies the format table. It is an array of structures
                that contain the cylinder number, head number, sector
                identifier, and bytes per sector for each sector on the
                track. The bCylinder field specifies the cylinder number.
                The bHead field specifies the head number. The idSector
                field specifies the sector identifier, and the bBytesSector
                field specifies the number of bytes per sector. The first
                element defines these values for the first sector. The
                number of elements depends on the number of sectors on the
                track. The bBytesSector field can be one of the following
                values:
 
                Value   Meaning
                ────────────────────────────────────────────────────────────
                0x0000  128 bytes per sector
 
                0x0001  256 bytes per sector
 
                0x0002  512 bytes per sector
 
                0x0003  1024 bytes per sector
 
                All the cylinder and head numbers must be the same.
 
See Also
 
DSK_FORMATVERIFY
 
                                      ♦