Method

GUPnPDeviceInfoget_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`.