Int 21/AH=40h

Prev Next Ralf Interrups Categories Contents

------

DOS 2+ - WRITE - WRITE TO FILE OR DEVICE

AH = 40h
BX = file handle
CX = number of bytes to write
DS:DX -> data to write

Return:
CF clear if successful AX = number of bytes actually written CF set on error AX = error code (05h,06h) (see #01680 at AH=59h/BX=0000h)

Notes: If CX is zero, no data is written, and the file is truncated or extended to the current position. Data is written beginning at the current file position, and the file position is updated after a successful write. For FAT32 drives, the file must have been opened with AX=6C00h with the "extended size" flag in order to expand the file beyond 2GB; otherwise the write will fail with error code 0005h (access denied). The usual cause for AX < CX on return is a full disk

BUG: A write of zero bytes will appear to succeed when it actually failed if the write is extending the file and there is not enough disk space for the expanded file (DOS 5.0-6.0); one should therefore check whether the file was in fact extended by seeking to 0 bytes from the end of the file (INT 21/AX=4202h/CX=0000h/DX=0000h). Under the FlashTek X-32 DOS extender, the pointer is in DS:EDX

See Also: AH=28h - AH=3Fh"DOS" - AH=93h - INT 2F/AX=1109h

Category: DOS Kernel - Int 21h - D

------

Prev Next Ralf Interrups Categories Contents