Method

GUPnPAVDIDLLiteObjectget_compat_resource

Declaration [src]

GUPnPDIDLLiteResource*
gupnp_didl_lite_object_get_compat_resource (
  GUPnPDIDLLiteObject* object,
  const char* sink_protocol_info,
  gboolean lenient
)

Description [src]

Use this function to get a resource from the object that is compatible with any of the protocols specified in the sink_protocol_info. The value of sink_protocol_info will typically be acquired from ‘Sink’ argument of ‘GetProtocolInfo’ action or ‘SinkProtocolInfo’ state-variable of a ConnectionManager service.

If lenient is TRUE, the first resource in the list is returned instead of NULL if none of resources and protocols are found to be compatible.

Parameters

sink_protocol_info

Type: const char*

The SinkProtocolInfo string from MediaRenderer.

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

Type: gboolean

Enable lenient mode.

Return value

Type: GUPnPDIDLLiteResource

The resource belonging to object that is comaptible with any of the protocols specified in sink_protocol_info, or NULL. Unref after usage.

The caller of the method takes ownership of the returned data, and is responsible for freeing it.