---
name: "giiQueryDeviceInfo"
section: "3"
platform: "linux"
package: "libgii1"
version: "1:1.0.2-4.1"
release: "Debian 7 (Wheezy)"
platforms: ["linux"]
url: "https://new.carta.tech/giiQueryDeviceInfo"
---

# giiQueryDeviceInfo(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_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)`