Name

giiQueryDeviceInfo, giiQueryDeviceInfoByNumber — Get information about a given GII input source

Synopsis

#include <ggi/gii.h>
int giiQueryDeviceInfo(inp,  
 origin,  
 info); 
gii_input_t * inp;
uint32  origin;
gii_cmddata_getdevinfo * info;
int giiQueryDeviceInfoByNumber(inp,  
 number,  
 origin,  
 info); 
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 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, which has the following fields:

longname

Name of the device (string, 74+\0 chars max)

shortname

Abbreviated devicename (string, 4+\0 chars max)

gii_event_mask can_generate

Events this device can generate

num_buttons

Number of keys/buttons this device has

num_axes

Number of valuator axes the device has

Return value

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

See Also

giiQueryValInfo(3)