29.12.2012 Views

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 ...

SHOW MORE
SHOW LESS

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

Hooray! Your file is uploaded and ready to be published.

Saved successfully!

Ooh no, something went wrong!