Thank you Paul for your feedback. We will fix all the typos/formatting issues. You flagged two important points, see my answers below.
+/** struct SndAudioCodecDescriptor - description of codec capabilities
- @maxChannels: maximum number of audio channels
- @minBitsPerSample: Minimum bits per sample of PCM data <FIXME: needed?>
- @maxBitsPerSample: Maximum bits per sample of PCM data <FIXME: needed?>
More elaborate explanation for the FIXME (in the commit message)?
These fields were defined by OpenMAX AL and make sense for a software implementation of encoders/decoders. In our case the DSP may be a 24-bit CPU, or a 32-bit one, or a 16-bit one with double precision. I believe it's useless to specify the internal PCM format to be used by the DSP, this should be defined by the firmware implementers. We decided to leave these fields for now, and see if anyone had a good reason to keep them. If no one speaks up they will be removed.
- @isFreqRangeContinuous: TRUE if the device supports a continuous range of
sampling rates between minSampleRate and maxSampleRate;
otherwise FALSE <FIXME: needed?>
This also comes from OpenMAX AL. I don't know of any hardware implementation where the audio rate can be specified with an arbitrary value. Again if we don't see anyone needing this field, it'll be removed.