NAME
giiQueryDeviceInfo, giiQueryDeviceInfoByNumber - Get information about
input sources
SYNOPSIS
#include <ggi/gii.h>‘
int giiQueryDeviceInfo (gii_input_t inp, uint32_t origin,
gii_cmddata_getdevinfo *info);
int giiQueryDeviceInfoByNumber(gii_input_t inp, uint32_t number,
uint32_t *origin, gii_cmddata_getdevinfo *info);
DESCRIPTION
Though when using GII inputs the exact type of device is fully
transparent to the program, information about the device that is
actually attached to a given gii input and origin id can be queried,
e.g. for configuration interfaces.
For giiQueryDeviceInfo the parameters inp and origin select the input
to query. This version is usually used, if you want to identify a
device after getting an event from it.
For giiQueryDeviceInfoByNumber the parameters inp and number select the
input to query - origin gets set to the origin ID the queried device
has. This version is used, when you want to query all known devices.
The queried data is put into info. See gii_cmddata_getdevinfo(3) for
the description of the structure.
RETURN VALUE
Returns 0 on success (info is valid, then) or -1 otherwise.
SEE ALSO
giiQueryValInfo(3)