ioctl12.hlp (Topic list)
DSK_WRITETRACK (1.2)
                                                      Up Next Previous
────────────────────────────────────────────────────────────────────────────
 
#define INCL_DOSDEVIOCTL
 
USHORT DosDevIOCtl(pbBuffer, pbCommand, 0x0044, 0x0008, hDevice)
PBYTE pbBuffer;     /* pointer to buffer with data       */
PBYTE pbCommand;    /* pointer to structure with command */
HFILE hDevice;      /* device handle                     */
 
The DSK_WRITETRACK function writes to a track on a specified disk drive.
 
Parameter  Description
────────────────────────────────────────────────────────────────────────────
 
pbBuffer   Points to the buffer that contains the data to be written.
 
pbCommand  Points to the TRACKLAYOUT structure that contains information
           about the write operation.
 
hDevice    Identifies the disk drive that receives the device-control
           function. The handle must have been created previously by using
           the DosOpen function.
 
Return Value
 
The return value is zero if the function is successful or an error value if
an error occurs.
 
Comments
 
The track-layout table passed in the function determines the sector number,
which is passed to the disk controller. When the sectors are odd-numbered or
nonconsecutive, the request is broken into an appropriate number of
single-sector operations, and one sector at a time is written.
 
See Also
 
DosOpen, DSK_READTRACK, PDSK_READPHYSTRACK, PDSK_WRITEPHYSTRACK,
TRACKLAYOUT