Sound_ReadSysInfo 2 (changes)
Showing changes from revision #2 to #3:
Added | Removed | Changed
Programmer's SoundDMA Reference Manuals
» Part 15 – SWI Calls
» Sound Sound_ReadSysInfo
» Sound_ReadSysInfo 2Sound_ReadSysInfo
» Sound_ReadSysInfo 2
Sound_ReadSysInfo 2
| Entry | |
|---|---|
| R0 | 2 (reason code) |
| R1 | Pointer to buffer for result, or 0 to check required length |
| R2 | Length of buffer |
| Exit | |
|---|---|
| R0 | 0, or error (e.g. buffer overflow) |
| R1 | Buffer updated with null-terminated string (if sufficient space available) |
| R2 | Length of data (including terminator) |
Use
The purpose of this call is to read the ID string of the current audio controller device.
Notes
Many versions of SoundDMA do not return errors when unknown SWIs are called. Therefore, to detect if this SWI is supported, check if R0 has been set to 0 on exit (Valid reason codes start at 1).
If the supplied buffer is not large enough, or the pointer was 0, a buffer overflow error will be generated and no data will be copied to the buffer.
See also
Social
Follow us on
and
and
ROOL Store
Buy RISC OS Open merchandise here, including SD cards for Raspberry Pi and more.