qdosmsq:traps:trap_2:cnam
IOA_CNAM
This trap fetches a channel name. SQMS Only.
| Call Parameters | Return Parameters | ||
|---|---|---|---|
| D0.B | $06 | D0.L | Error code. |
| D2.W | Maximum length of string | D2.L | Preserved. |
| A0.L | Channel ID | A0.L | Preserved. |
| A1.L | Pointer to buffer | A1.L | Preserved. |
Errors
| ERR_NO | Channel not open. |
| ERR_BP | Bad parameter. |
| ERR_NI | Not implemented. |
Notes
- All registers not listed above are not used and are preserved.
- D2.W must be at least 43 otherwise a "bad parameter" error will be signalled.
- This routine appears not to work with RAM or DOS files when it gives a "not implemented" error.
Example
This shows a channel name being set in a buffer.
; A0 contains the channel ID
get_name lea ans,a1 ; ans will hold the name
moveq #43,d2 ; Must be greater than 42
moveq #$06,d0 ; IOA_CNAM
trap #2 ; Fetch the name
tst.l d0 ; OK? . .
bra oops ; . . no!
; Now the name should be in "ans" as a QDOS string.
ans ds.b 43
qdosmsq/traps/trap_2/cnam.txt · Last modified: 2009/07/07 07:38 by norman
