[ prev :: next :: up ] libgii-current (3)

Get information about input sources

Name

giiQueryDeviceInfo, giiQueryDeviceInfoByNumber : Get information about input sources

Synopsis

#include <ggi/gii.h>`

int giiQueryDeviceInfo (gii_input_t inp, uint32 origin,
                        gii_cmddata_getdevinfo *info);

int giiQueryDeviceInfoByNumber(gii_input_t inp, uint32 number,
                               uint32 *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 :p:`inp` and :p:`origin` select the input to query. This version is usually used, if you want to identify a device after getting an event from it.

System Message: ERROR/3 (../ggi-core/libgii/doc/libgii.txt, line 598); backlink

Unknown interpreted text role "p".

System Message: ERROR/3 (../ggi-core/libgii/doc/libgii.txt, line 598); backlink

Unknown interpreted text role "p".

For giiQueryDeviceInfoByNumber the parameters :p:`inp` and :p:`number` select the input to query - :p:`origin` gets set to the origin ID the queried device has. This version is used, when you want to query all known devices.

System Message: ERROR/3 (../ggi-core/libgii/doc/libgii.txt, line 602); backlink

Unknown interpreted text role "p".

System Message: ERROR/3 (../ggi-core/libgii/doc/libgii.txt, line 602); backlink

Unknown interpreted text role "p".

System Message: ERROR/3 (../ggi-core/libgii/doc/libgii.txt, line 602); backlink

Unknown interpreted text role "p".

The queried data is put into :p:`info`. See :man:`gii_cmddata_getdevinfo(3)` for the description of the structure.

System Message: ERROR/3 (../ggi-core/libgii/doc/libgii.txt, line 608); backlink

Unknown interpreted text role "p".

System Message: ERROR/3 (../ggi-core/libgii/doc/libgii.txt, line 608); backlink

Unknown interpreted text role "man".

Return value

Returns 0 on success (info is valid, then) or -1 otherwise.

See Also

:man:`giiQueryValInfo(3)`

System Message: ERROR/3 (../ggi-core/libgii/doc/libgii.txt, line 621); backlink

Unknown interpreted text role "man".
 
[ prev :: next :: up ] libgii-current (3)
2006/08/09 02:58:14