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`

  Type: `const char*`

  The type of the device to be retrieved.

  The data is owned by the caller of the method.
  The value is a NUL terminated UTF-8 string.

#### Return value

Type: `GUPnPDeviceInfo`

A new `GUPnPDeviceInfo`.

The caller of the method takes ownership of the returned data, and is responsible for freeing it.
The return value can be `NULL`.