CD Actual 15

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

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

Wrap

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

..pgno01 ..foot60A8-## ..head02L────────────────────────────────────────────────────────────────────── ..head04L────────────────────────────────────────────────────────────────────── ..head03AdChDir ■ Dos Versions [2.0+] ■ Source Module Name d213B00d.asm ■ Description Change to specified directory ■ Summary INT FPENTRY dChDir( CHAR *Path ); 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 INT FPENTRY dCloseFile( INT2 *Handle ); 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 INT FPENTRY dCreateFile( CHAR *Path, INT2 Attr, INT2 *Handle ); 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 VOID FPENTRY dCreateNewPsp( UINT2 Segment ); 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 INT FPENTRY dDelFile( CHAR *FileSpec ); 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 VOID FPENTRY dDiskReset( VOID ); ■ 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 INT FPENTRY dGetBreakStatus( VOID ); ■ 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 VOID FPENTRY dGetBusyFlag( UINT2 *dSeg, UINT2 *dOfs ); 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 INT2 FPENTRY dGetCurrentDisk( VOID ); ■ 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 VOID FPENTRY dGetDate( INT2 *Month, INT2 *Day, INT2 *Year, INT2 *DayOfWk ); 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 INT FPENTRY dGetDriveData( INT2 Drive, UINT2 *Sectors, UINT2 *MediaSeg, UINT2 *MediaOfs, UINT2 *SectorSize, UINT2 *Clusters ); 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 INT FPENTRY dGetDrvAllocInfo( UINT Drive, UINT *Sectors, UINT *AvailClusters, UINT *BytesInSector, UINT *TotalClusters ); 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 VOID FPENTRY dGetDta( UINT2 *Segment, UINT2 *Offset ); 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 INT FPENTRY dGetFileAttr( CHAR *FileSpec, INT2 *Attr ); 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 VOID FPENTRY dGetIntVec( UINT2 dInt, UINT2 *dSeg, UINT2 *dOfs ); 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 VOID FPENTRY dGetTime( INT2 *Hour, INT2 *Minute, INT2 *Seconds, INT2 *Hundredths ); Parameter Description ───────── ───────────────────────────────────────────────── Hour returns the hour (0-23) on 24 hour clock Minute returns the minute (0-59) Seconds returns the seconds (0-59) Hundredths 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 VOID FPENTRY dGetVersion( INT2 *Major, INT2 *Minor ); 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 INT2 FPENTRY dMkDir( CHAR *Path ); 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 INT FPENTRY dOpenFile( CHAR *Path, INT2 Mode, INT2 *Handle ); 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 INT FPENTRY dReadFile( INT Handle, UINT2 NBytes, VOID *Buffer, UINT2 *BytesRead ); 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 INT FPENTRY dRmDir( CHAR *Path ); 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 INT2 FPENTRY dSelectDisk( INT2 Drive ); 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 VOID FPENTRY dSetBreakFlag( INT flag ); 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 INT FPENTRY dSetDate( INT Month, INT Day, INT Year ); 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 VOID FPENTRY dSetDta( UINT2 Segment, UINT2 Offset ); 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 INT FPENTRY dGetFileAttr( CHAR *FileSpec, INT2 *Attr ); 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 INT FPENTRY dSetFilePos( INT2 Handle, INT Method, INT4 *Ofs ); 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 VOID FPENTRY dSetInt( UINT2 Int, UINT2 Segment, UINT2 Offset ); Parameter Description ───────── ───────────────────────────────────────────────── Int Interrupt number Segment Segment of the new interrupt routine Offset 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 VOID FPENTRY dSetTime( INT2 Hour, INT2 Minute, INT2 Seconds, INT2 Hundredths ); Parameter Description ───────── ───────────────────────────────────────────────── Hour the hour (0-23) on 24 hour clock Minute the minute (0-59) Seconds the seconds (0-59) Hundredths 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 VOID FPENTRY dSetVerifyFlag( INT2 VerifyOpt ); 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 INT FPENTRY dWriteFile( INT Handle, UINT NBytes, VOID *Buffer, UINT *BytesWritten ); 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