GUPnP.DeviceInfo.get_device

### Method

# GUPnP DeviceInfoget_device

#### Declaration [src]

    GUPnPDeviceInfo*
    gupnp_device_info_get_device (
      GUPnPDeviceInfo* info,
      const char* type
    )

#### Description [src]

Get the device with type `type` directly contained in `info` as a new object implementing `GUPnPDeviceInfo`, or `NULL` if no such device was found. The returned object should be unreffed when done.

Note that devices are not cached internally, so that every time you call this function a new object is created. The application must cache any used devices if it wishes to keep them around and re-use them.

#### Parameters

`type` | `const char*`
| The type of the device to be retrieved.
| The data is owned by the caller of the function.
| The value is a NUL terminated UTF-8 string.

#### Return value

Returns: | `GUPnPDeviceInfo`
| A new `GUPnPDeviceInfo`.
| The caller of the method takes ownership of the data, and is responsible for freeing it.
| The return value can be `NULL`.