CD Actual 15

home *** CD-ROM | disk | FTP | other *** search

/ CD Actual 15 / CDACTUAL15.iso / cdactual / program / pascal / PASLIBR.ZIP / CH8_1.DOC < prev next >

Wrap

Text File | 1991-03-15 | 17.6 KB | 829 lines

..pgno01 ..foot60A8-## ..head02L----------------------------------------------------------------- ..head04L----------------------------------------------------------------- ..head03AdChDir ■ Dos Versions [2.0+] ■ Source Module Name d213B00d.asm ■ Description Change to specified directory ■ Summary Function dChDir( Path : String ) : Integer; Parameter Description --------- ------------------------------------------------- Path path to change to ■ Function Return Value 0 - function successfully changed path ..page ..head03AdCloseFile ■ Dos Versions [2.0+] ■ Source Module Name d213E00d.asm ■ Description Closes any file that was previously opened or created with a call to dCreateFile or dOpenFile. ■ Summary Function dCloseFile( Var Handle : Integer ) : Integer; Parameter Description --------- ------------------------------------------------- Handle handle of the file to close ■ Function Return Value 0 - function successfully closed file ..page ..head03AdCreateFile ■ Dos Versions [2.0+] ■ Source Module Name d213C00d.asm ■ Description Creates a new file in the specified or default directory on the specified or default drive. If the file already exists then the file is truncated to length zero. ■ Summary Function dCreateFile( Path : String; Attr : Integer; Var Handle : Integer ) : Integer; Parameter Description --------- ------------------------------------------------- Path path and filename of file to create Attr attribute to create file with Handle returns the handle of the file created ■ Function Return Value 0 - function successfully changed path ..page ..head03AdCreateNewPsp ■ Dos Versions [1.1+] ■ Source Module Name d212600d.asm ■ Description Copies current programs psp to a specified segment address in free memory before updating the psp to make it usable by another program. ■ Summary Procedure dCreateNewPsp( Segment : Word ); Parameter Description --------- ------------------------------------------------- Segment Segment of the new psp ■ Function Return Value Nothing. ..page ..head03AdDelFile ■ Dos Versions [2.0+] ■ Source Module Name d214100d.asm ■ Description Delete specified file from the disk. ■ Summary Function dDelFile( FileSpec : String ) : Integer; Parameter Description --------- ------------------------------------------------- FileSpec asciiz string containing the drive path and filename of the file to be deleted. ■ Function Return Value 0 - file deleted ok 1 - error trying to delete file ..page ..head03AdDiskReset ■ Dos Versions [1.1+] ■ Source Module Name d210D00d.asm ■ Description Flush all file buffers. All data in the MS-DOS buffers are physically written to the disk. The disk directory is NOT updated. ■ Summary Procedure dDiskReset; ■ Function Return Value Nothing ..page ..head03AdGetBreakStatus ■ Dos Versions [2.0+] ■ Source Module Name d213300d.asm ■ Description Get the status of the systems break flag that influences ctrl-c checking. ■ Summary Function dGetBreakStatus : Integer; ■ Function Return Value 0 - Break flag is OFF 1 - Break flag is ON ..page ..head03AdGetBusyFlag ■ Dos Versions [2.0+?] ■ Source Module Name d213400u.asm ■ Description Get the address of the MS-DOS busy flag ■ Summary Procedure dGetBusyFlag( Var dSeg, dOfs : Word ); Parameter Description --------- ------------------------------------------------- dSeg returns the segment of the dos busy flag var dOfs returns the offset of the dos busy flag var ■ Function Return Value Segment:Offset address of the MS-DOS busy flag ..page ..head03AdGetCurrentDisk ■ Dos Versions [1.1+] ■ Source Module Name d211900d.asm ■ Description Get the number of the default disk drive. (0=A, 1=B, etc). ■ Summary Function dGetCurrentDisk : Integer; ■ Function Return Value The drive code of the default disk drive. ..page ..head03AdGetDate ■ Dos Versions [1.1+] ■ Source Module Name d212A00d.asm ■ Description Use Dos to retrieve the system date ■ Summary Procedure dGetDate( Var Month, Day, Year, DayOfWk : Integer ); Parameter Description --------- ------------------------------------------------- Month returns the month of the year Day returns the day of the month Year returns the year (1980 thru 2099) DayOfWk returns the day of the week ( 0-6 ) where: 0 -> Sunday 6 -> Saturday ■ Function Return Value Nothing. ..page ..head03AdGetDriveData ■ Dos Versions [2.0+] ■ Source Module Name d211C00d.asm ■ Description Retrieve information about the default disk drive ■ Summary Function dGetDriveData( Drive : Integer; Var Sectors : Word; Var MediaSeg : Word; Var MediaOfs : Word; Var SectorSize : Word; Var Clusters : Word ) : Integer; Parameter Description --------- ------------------------------------------------- Drive drive code of the drive to get the data on. (0=default, 1=A, 2=B, etc.) Sectors Number of sectors per cluster MediaSeg Segment of the media id byte MediaOfs Offset of the media id byte SectorSize Number of bytes per sector Clusters Number of clusters on the drive ■ Function Return Value 0 - unsuccessful (invalid drive, etc) 1 - successful ..page ..head03AdGetDrvAllocInfo ■ Dos Versions [2.0+] ■ Source Module Name d213600d.asm ■ Description Get information about a specified disk drive. ■ Summary Function dGetDrvAllocInfo( Drive : Word; Var Sectors : Word; Var AvailClusters : Word; Var BytesInSector : Word; Var TotalClusters : Word ) : Integer; Parameter Description --------- ------------------------------------------------- Drive disk drive code (0=default, 1=A, etc) Sectors number of sectors in a cluster AvailClusters number of available clusters BytesInSector number of bytes in a sector TotalClusters number of clusters in drive ■ Function Return Value 0 - function unable to obtain information for drive 1 - function successfully obtained information ..page ..head03AdGetDta ■ Dos Versions [2.0+] ■ Source Module Name d212F00d.asm ■ Description Gets the current address of the disk transfer area being used for file related functions. ■ Summary Procedure dGetDta( Var Segment, Offset : Word ); Parameter Description --------- ------------------------------------------------- Segment Segment of the DTA Offset Offset of the DTA ■ Function Return Value The segment and offset of the dta. ..page ..head03AdGetFileAttr ■ Dos Versions [2.0+] ■ Source Module Name d214300d.asm ■ Description Gets the attribute for the specified file. ■ Summary Function dGetFileAttr( FileSpec : String; Var Attr : Integer ) : Integer; Parameter Description --------- ------------------------------------------------- FileSpec handle of file to set file pointer Attr relative position to set location of pointer from ■ Function Return Value 0 - file attribute obtained ok 1 - error trying to obtain files attribute ..page ..head03AdGetIntVec ■ Dos Versions [2.0+] ■ Source Module Name d2135xxd.asm ■ Description Get the address of the specified Interrupt ■ Summary Procedure dGetIntVec( dInt : Word; Var dSeg : Word; Var dOfs : Word ); Parameter Description --------- ------------------------------------------------- dInt interrupt vector to retrieve dSeg returns the segment of the interrupt specified dOfs returns the offset of the interrupt specified ■ Function Return Value Segment:Offset of specified interrupt ..page ..head03AdGetTime ■ Dos Versions [1.1+] ■ Source Module Name dd212C00d.asm ■ Description Use Dos to retrieve the system time ■ Summary Procedure dGetTime( Var Hour, Min, Sec, Hund : Integer ); Parameter Description --------- ------------------------------------------------- Hour returns the hour (0-23) on 24 hour clock Min returns the minute (0-59) Sec returns the seconds (0-59) Hund returns the hundredths of a second (0-99) ■ Function Return Value Nothing. ..page ..head03AdGetVersion ■ Dos Versions [2.0+] ■ Source Module Name d213000d.asm ■ Description Get the version number of the MS-DOS operating system. ■ Summary Procedure dGetVersion( Var Major, Minor : Integer ); Parameter Description --------- ------------------------------------------------- Major Major version number Minor Minor version number ■ Function Return Value Version number of operating system. ..page ..head03AdMkDir ■ Dos Versions [2.0+] ■ Source Module Name d213900d.asm ■ Description Create directory using specified path ■ Summary Function dMkDir( Path : String ) : Integer; Parameter Description --------- ------------------------------------------------- Path path to create ■ Function Return Value 0 - function successfully created path n - error code ..page ..head03AdOpenFile ■ Dos Versions [2.0+] ■ Source Module Name d213D00d.asm ■ Description Opens any existing file in the specified or default directory on the specified or default drive. ■ Summary Function dOpenFile( Path : String; Mode : Integer; Var Handle : Integer ) : Integer; Parameter Description --------- ------------------------------------------------- Path path and filename of file to create Mode attribute for the file Handle returns the handle of the file created ■ Function Return Value 0 - function successfully changed path ..page ..head03AdReadFile ■ Dos Versions [2.0+] ■ Source Module Name d213F00d.asm ■ Description Read specified number of bytes from file into data buffer ■ Summary Function dReadFile( Handle : Integer; NBytes : Word; Var Buffer ; Var BytesRead : Word ) : Integer; Parameter Description --------- ------------------------------------------------- Handle valid file handle of file to read from NBytes number of bytes to read Buffer data area to place data read from file BytesRead number of actual bytes read ■ Function Return Value 0 - file read performed ok 1 - error trying to read file ..page ..head03AdRmDir ■ Dos Versions [2.0+] ■ Source Module Name d213A00d.asm ■ Description Remove specified directory ■ Summary Function dRmDir( Path : String ) : Integer; Parameter Description --------- ------------------------------------------------- Path path to remove ■ Function Return Value 0 - function successfully created path n - error code ..page ..head03AdSelectDisk ■ Dos Versions [1.1+] ■ Source Module Name d210E00d.asm ■ Description Sets the specified drive to the default drive and returns the number of logical drives in the system. ■ Summary Function dSelectDisk( Drive : Integer ) : Integer; Parameter Description --------- ------------------------------------------------- Drive drive number (0=A, 1=B, etc ) ■ Function Return Value The number of logical drives. ..page ..head03AdSetBreakFlag ■ Dos Versions [2.0+] ■ Source Module Name d213301d.asm ■ Description Sets the break flag to ON or OFF ■ Summary Procedure dSetBreakFlag( flag : Integer ); Parameter Description --------- ------------------------------------------------- flag 0 - to set break flag OFF 1 - to set break flag ON ■ Function Return Value Nothing. ..page ..head03AdSetDate ■ Dos Versions [1.1+] ■ Source Module Name d212B00d.asm ■ Description Use Dos to set the system to a specified date ■ Summary Function dSetDate( Month, Day, Year : Integer ) : Integer; Parameter Description --------- ------------------------------------------------- Month month of year (1-12) Day day of month (1-31) Year year 1980-2099 ■ Function Return Value 0 - invalid date 1 - date set successfully ..page ..head03AdSetDta ■ Dos Versions [1.1+] ■ Source Module Name d211A00d.asm ■ Description Sets the address of the disk transfer area to be used for file related functions. ■ Summary Procedure dSetDta( Segment, Offset : Word ); Parameter Description --------- ------------------------------------------------- Segment Segment of the new DTA Offset Offset of the new DTA ■ Function Return Value Nothing. ..page ..head03AdSetFileAttr ■ Dos Versions [2.0+] ■ Source Module Name d214301d.asm ■ Description Sets file position relative to beginning of file, current file position, or end of file. ■ Summary Function dGetFileAttr( FileSpec : String; Var Attr : Integer ) : Integer; Parameter Description --------- ------------------------------------------------- FileSpec handle of file to set file pointer Attr relative position to set location of pointer from ■ Function Return Value 0 - file attribute obtained ok 1 - error trying to obtain files attribute ..page ..head03AdSetFilePos ■ Dos Versions [2.0+] ■ Source Module Name d214200d.asm ■ Description Sets file position relative to beginning of file, current file position, or end of file. ■ Summary Function dSetFilePos( Handle : Integer; Method : Integer; Var Ofs : LongInt ) : Integer; Parameter Description --------- ------------------------------------------------- Handle handle of file to set file pointer Method relative position to set location of pointer from Ofs number of bytes to move pointer. returns the absolute file position from the beginning of the file. ■ Function Return Value 0 - file pointer moved ok 1 - error trying to move file pointer ..page ..head03AdSetInt ■ Dos Versions [1.1+] ■ Source Module name d2125xxd.asm ■ Description Initialize the systems interrupt vector to point to a user defined interrupt handling routine. ■ Summary Procedure dSetInt( Interp, Seg, Ofs : Word ); Parameter Description --------- ------------------------------------------------- Interp Interrupt number Seg Segment of the new interrupt routine Ofs Offset of the new interrupt routine ■ Function Return Value Nothing. ..page ..head03AdSetTime ■ Dos Versions [1.1+] ■ Source Module Name dd212D00d.asm ■ Description Use Dos to set the system clock to a specified time ■ Summary Procedure dSetTime( Hour, Min, Sec, Hund : Integer ); Parameter Description --------- ------------------------------------------------- Hour the hour (0-23) on 24 hour clock Min the minute (0-59) Sec the seconds (0-59) Hund the hundredths of a second (0-99) ■ Function Return Value 0 - invalid time 1 - time set successfully ..page ..head03AdSetVerityFlag ■ Dos Versions [1.1+] ■ Source Module Name d212E00d.asm ■ Description Turns the automatic read-after-write verification ON or OFF. ■ Summary Procedure dSetVerifyFlag( VerifyOpt : Integer ); Parameter Description --------- ------------------------------------------------- VerifyOpt 0 - Turn OFF verify flag 1 - Turn ON verify flag ■ Function Return Value Nothing. ..page ..head03AdWriteFile ■ Dos Versions [2.0+] ■ Source Module Name d214000d.asm ■ Description Write specified number of bytes to file from data buffer ■ Summary Function dWriteFile( Handle : Integer; NBytes : Word; Var Buffer ; Var BytesWritten : Word; ) : Integer; Parameter Description --------- ----------------------------------------------- Handle valid file handle of file to write to NBytes number of bytes to write Buffer data area containing data to write BytesWritten number of actual bytes written ■ Function Return Value 0 - file write operation performed ok 1 - error trying to write file ..page