The Programmer's Guide to TRSDOS Version 6 - Tim Mann's Home ...
The Programmer's Guide to TRSDOS Version 6 - Tim Mann's Home ...
The Programmer's Guide to TRSDOS Version 6 - Tim Mann's Home ...
Create successful ePaper yourself
Turn your PDF publications into a flip-book with our unique Google optimized e-Paper software.
7.6.18 @DCSTAT SVC-40<br />
This SVC passes a function 0 <strong>to</strong> a disk driver. It is commonly used for testing the status<br />
of a logical drive. A disk driver should return with no error on function 0. Thus, if a<br />
particular drive is disabled, the system will return an error-32 <strong>to</strong> the calling program.<br />
Chapter 4 has more information.<br />
Registers Affected: AF [Note: DOS saves BC, IY; drivers should save any other<br />
registers they use].<br />
Entry:<br />
C Logical drive number (0-7).<br />
Exit:<br />
A Error return code, if any.<br />
Z Set if the operation was successful.<br />
7.6.19 @DEBUG SVC-27<br />
This SVC will force the system <strong>to</strong> enter the DEBUGging package.<br />
Registers Affected: None except those changed by the user.<br />
7.6.20 @DECHEX SVC-96<br />
This SVC performs the conversion of a decimal string of digits <strong>to</strong> their binary<br />
value in a 16-bit field. Overflow is not trapped. <strong>The</strong> conversion s<strong>to</strong>ps on the first digit<br />
found not <strong>to</strong> be in the range . <strong>The</strong> linkage is:<br />
Registers Affected: AF, BC, HL.<br />
Entry:<br />
HL => A pointer <strong>to</strong> your decimal string.<br />
Exit:<br />
BC Returns the resultant 16-bit binary value of "string".<br />
HL Points <strong>to</strong> 1st non-decimal digit.<br />
Z-flag is indeterminate<br />
7.6.21 @DIRRD SVC-87<br />
This SVC will read a direc<strong>to</strong>ry sec<strong>to</strong>r containing the direc<strong>to</strong>ry entry for a specified<br />
Direc<strong>to</strong>ry Entry Code (DEC). <strong>The</strong> sec<strong>to</strong>r will be written <strong>to</strong> the system buffer, SBUFF$, and<br />
the register pair HL will point <strong>to</strong> the first byte of the direc<strong>to</strong>ry entry specified by the<br />
DEC. Note that this is a method <strong>to</strong> recover the page address of the system's buffer by<br />
keeping register-H after an @DIRRD invocation. See the sections on HASH INDEX TABLE and<br />
DIRECTORY RECORD FORMAT for additional information.<br />
Registers Affected: AF, HL.<br />
Entry:<br />
B Direc<strong>to</strong>ry Entry Code of the file.<br />
C Logical drive number (0-7).<br />
Exit:<br />
HL Points <strong>to</strong> the DEC's direc<strong>to</strong>ry entry.<br />
A Error return code, if any.<br />
Z Set if no error is encountered.<br />
7-16