RISC OS Open
A fast and easily customised operating system for ARM devices
ROOL
Home | News | Downloads | Bugs | Bounties | Forum | Documents | Photos | Contact us
Account

Sound_EnumerateControllers

SoundDMA
» SWI Calls
» Sound_EnumerateControllers

Sound_EnumerateControllers

(SWI &40149)
Entry
R0 Pointer to space/control terminated controller ID string to start from, or 0 or an empty string to start enumeration
R1 Pointer to buffer for result (can be R0), or 0 to check required length
R2 Length of buffer
Exit
R0 0, or pointer to error block
R1 Buffer updated with null-terminated ID string of next controller, or empty string if no more controllers
R2 Length of data (including null terminator)

Use

This call can be used to enumerate the audio controller devices that are available for use by the sound system.

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), or use Sound_ReadSysInfo 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

  • Sound SWI Calls
  • Sound_ReadSysInfo
  • Sound_SelectDefaultController
  • Sound_ControllerInfo
Revised on November 13, 2017 01:42:57 by Alan Robertson (52) (49.192.18.196)
Edit | Back in time (2 revisions) | See changes | History | Views: Print | Source | Linked from: Sound SWI Calls, Sound_ReadSysInfo 1, Sound_ReadSysInfo 2, Sound_ControllerInfo, SoundCtrl_ExamineMixer, Sound_SelectDefaultController, *MixVolume, SoundCtrl_GetMix, SoundCtrl_SetMix, SoundDMA SWI Calls

Search the Wiki

Social

Follow us on and

ROOL Store

Buy RISC OS Open merchandise here, including SD cards for Raspberry Pi and more.

Donate! Why?

Help ROOL make things happen – please consider donating!

RISC OS IPR

RISC OS is an Open Source operating system owned by RISC OS Developments Ltd and licensed primarily under the Apache 2.0 license.

Navigation

  • Home Page
  • All Pages
  • Recently Revised
  • Authors
  • Feeds
Site design © RISC OS Open Limited 2018 except where indicated
The RISC OS Open Instiki theme is based on Insitki's default layout

Valid XHTML 1.0  |  Valid CSS

Instiki 0.19.1(MML+)
This site runs on Rails

Hosted by Arachsys