The RtAudio Home Page

// probe.cpp

#include <iostream>
#include "RtAudio.h"

int main()
{
  RtAudio audio;

  // Determine the number of devices available
  unsigned int devices = audio.getDeviceCount();

  // Scan through devices for various capabilities
  RtAudio::DeviceInfo info;
  for ( unsigned int i=1; i<=devices; i++ ) {

    info = audio.getDeviceInfo( i );

    if ( info.probed == true ) {
      // Print, for example, the maximum number of output channels for each device
      std::cout << "device = " << i;
      std::cout << ": maximum output channels = " << info.outputChannels << "\n";
    }
  }

  return 0;
}

The RtAudio::DeviceInfo structure is defined in RtAudio.h and provides a variety of information useful in assessing the capabilities of a device:

  typedef struct RtAudio::DeviceInfo {
    bool probed;                  // true if the device capabilities were successfully probed.
    std::string name;             // Character string device identifier.
    int outputChannels;           // Maximum output channels supported by device.
    int inputChannels;            // Maximum input channels supported by device.
    int duplexChannels;           // Maximum simultaneous input/output channels supported by device.
    bool isDefaultOutput;         // true if this is the default output device.
    bool isDefaultInput;          // true if this is the default input device.
    std::vector<int> sampleRates; // Supported sample rates.
    RtAudioFormat nativeFormats;  // Bit mask of supported data formats.
  };

  typedef unsigned long RtAudioFormat;
  static const RtAudioFormat  RTAUDIO_SINT8;   // Signed 8-bit integer
  static const RtAudioFormat  RTAUDIO_SINT16;  // Signed 16-bit integer
  static const RtAudioFormat  RTAUDIO_SINT24;  // Signed 24-bit integer (lower 3 bytes of 32-bit signed integer.)
  static const RtAudioFormat  RTAUDIO_SINT32;  // Signed 32-bit integer
  static const RtAudioFormat  RTAUDIO_FLOAT32; // 32-bit float normalized between +/- 1.0
  static const RtAudioFormat  RTAUDIO_FLOAT64; // 64-bit double normalized between +/- 1.0

The nativeFormats member of the RtAudio::DeviceInfo structure is a bit mask of the above formats which are natively supported by the device. However, RtAudio will automatically provide format conversion if a particular format is not natively supported. When the probed member of the RtAudio::DeviceInfo structure is false, the remaining structure members are undefined and the device is probably unusable.

Some audio devices may require a minimum channel value greater than one. RtAudio will provide automatic channel number compensation when the number of channels set by the user is less than that required by the device. Channel compensation is NOT possible when the number of channels set by the user is greater than that supported by the device.

It should be noted that the capabilities reported by a device driver or underlying audio API are not always accurate and/or may be dependent on a combination of device settings. For this reason, RtAudio does not rely on the queried values when attempting to open a stream.

Probing Device Capabilities