LIBFFADO 2.4.8
ffado_device_info Struct Reference

#include <ffado.h>

Public Attributes

unsigned int nb_device_spec_strings
 
char ** device_spec_strings
 
int32_t reserved [32]
 

Detailed Description

This struct serves to define the devices that should be used by the library device_spec_strings is an array of pointers that should contain nb_device_spec_strings valid pointers to strings.

The spec strings should be null terminated and can be no longer than FFADO_MAX_SPECSTRINGS.

nb_device_spec_strings < FFADO_MAX_SPECSTRING_LENGTH nb_device_spec_strings >= 0

If nb_device_spec_strings == 0, all busses are scanned for attached devices, and all found devices that are supported are combined into one large pseudo-device. The device order is defined by the GUID of the device. Devices with lower GUID's will be the first ones.

If multiple device specifications are present, the device order is defined as follows:

  • device(s) that correspond to a spec string with a lower index will be added before devices from higher indexes.
  • if a spec string results in multiple devices, they are sorted by GUID unless the spec format dictates otherwise.

The actual meaning of the device specification should be one of the following:

  • Format 1: "hw:x[,y[,z]]" x = the FireWire bus to use ('port' in raw1394 terminology) (mandatory) y = the node id the device currently has (bus resets might change that, but FFADO will track these changes and keep using the device specified on startup) (optional) z = the stream direction to use. 0 => capture (record) channels only 1 => playback channels only other/unspecified => both playback and capture (optional)
  • Format 2: the device alias as defined in the ffado config file (UNIMPLEMENTED)

Member Data Documentation

◆ device_spec_strings

char** ffado_device_info::device_spec_strings

◆ nb_device_spec_strings

unsigned int ffado_device_info::nb_device_spec_strings

◆ reserved

int32_t ffado_device_info::reserved[32]

The documentation for this struct was generated from the following file: