NAME

       egd_get_cap - Query various information about the device capabilities

SYNOPSIS

       #include <eegdev.h>

       int egd_get_cap(const struct eegdev* dev, int cap, void* val);

DESCRIPTION

       egd_get_cap()  returns  the  information  about  the  capability specified by cap of the recording device
       referenced by dev by the mean of the pointer val.

       The type of pointer passed through val is dependent on the requested capability cap which can be one  the
       following (The expected type pointed by val is provided in parenthesis):

       EGD_CAP_FS (int)
              Sampling frequency that is currently set. The same value is returned by the function.

       EGD_CAP_TYPELIST (const int*)
              Array  of  sensor  types  sampled  by  the  device  terminated by -1. These values became valid as
              argument for egd_sensor_name(3) when opening the device dev if  they  were  not  yet  before.  The
              number  of elements in the array (excluding the -1 element) is provided by the return value of the
              function.

       EGD_CAP_DEVTYPE (const char*)
              Null terminated string describing the type of the recording device (Manufacturer and model if  dev
              refers to actual hardware). The length of string (excluding the null character) is provided by the
              return value of the function.

       EGD_DEVID (const char*)
              Null-terminated string describing the model of the recording device (or an  unique  identifier  of
              the resource). The length of string (excluding the null character) is provided by the return value
              of the function.

RETURN VALUE

       In case of success, the function  returns  a  positive  value  depending  on  the  requested  capability.
       Otherwise, -1 is returned and errno is set accordingly.

ERRORS

       egd_get_cap() will fail if:

       EINVAL dev is NULL, cap is not valid value or val is NULL while cap is not EGD_CAP_FS.

SEE ALSO

       egd_sensor_name(3)