GUPnP DLNA Reference Manual | ||||
---|---|---|---|---|
Top | Description |
Synopsis
#define GUPNP_DLNA_BOOL_VALUE_UNSET #define GUPNP_DLNA_BOOL_VALUE_UNSUPPORTED #define GUPNP_DLNA_FRACTION_VALUE_UNSET #define GUPNP_DLNA_FRACTION_VALUE_UNSUPPORTED #define GUPNP_DLNA_INT_VALUE_UNSET #define GUPNP_DLNA_INT_VALUE_UNSUPPORTED #define GUPNP_DLNA_STRING_VALUE_UNSET #define GUPNP_DLNA_STRING_VALUE_UNSUPPORTED GUPnPDLNABoolValue; GUPnPDLNAFractionValue; GUPnPDLNAIntValue; GUPnPDLNAStringValue; enum GUPnPDLNAValueState;
Description
The GUPnPDLNABoolValue, GUPnPDLNAFractionValue, GUPnPDLNAIntValue and GUPnPDLNAStringValue hold respectively boolean, fraction, integer and string values.
The value can be in one of three possible states - set, unset or unsupported. When value is in set state it is possible to use the underlying value it holds. In other states using such value is undefined.
Main difference between unset state and unsupported state is that the former is set when metadata extractor is capable of extracting some attribute in general, but current media file does not have such attribute, while the latter means that metadata extractor has no idea how to extract such attribute at all.
One note on GUPnPDLNAStringValue - it holds a string that has to
be allocated with g_malloc()
(that is - g_strdup()
and others are
fine as well as they use g_malloc()
internally). The string is
freed by consumer.
Details
GUPNP_DLNA_BOOL_VALUE_UNSET
#define GUPNP_DLNA_BOOL_VALUE_UNSET
Static initializer for unset GUPnPDLNABoolValue. Can be used in two ways:
GUPnPDLNABoolValue value = GUPNP_DLNA_BOOL_VALUE_UNSET;
or
return GUPNP_DLNA_BOOL_VALUE_UNSET;
GUPNP_DLNA_BOOL_VALUE_UNSUPPORTED
#define GUPNP_DLNA_BOOL_VALUE_UNSUPPORTED
Static initializer for unsupported GUPnPDLNABoolValue. Can be used in two ways:
GUPnPDLNABoolValue value = GUPNP_DLNA_BOOL_VALUE_UNSUPPORTED;
or
return GUPNP_DLNA_BOOL_VALUE_UNSUPPORTED;
GUPNP_DLNA_FRACTION_VALUE_UNSET
#define GUPNP_DLNA_FRACTION_VALUE_UNSET
Static initializer for unset GUPnPDLNAFractionValue. Can be used in two ways:
GUPnPDLNAFractionValue value = GUPNP_DLNA_FRACTION_VALUE_UNSET;
or
return GUPNP_DLNA_FRACTION_VALUE_UNSET;
GUPNP_DLNA_FRACTION_VALUE_UNSUPPORTED
#define GUPNP_DLNA_FRACTION_VALUE_UNSUPPORTED
Static initializer for unsupported GUPnPDLNAFractionValue. Can be used in two ways:
GUPnPDLNAFractionValue value = GUPNP_DLNA_FRACTION_VALUE_UNSUPPORTED;
or
return GUPNP_DLNA_FRACTION_VALUE_UNSUPPORTED;
GUPNP_DLNA_INT_VALUE_UNSET
#define GUPNP_DLNA_INT_VALUE_UNSET
Static initializer for unset GUPnPDLNAIntValue. Can be used in two ways:
GUPnPDLNAIntValue value = GUPNP_DLNA_INT_VALUE_UNSET;
or
return GUPNP_DLNA_INT_VALUE_UNSET;
GUPNP_DLNA_INT_VALUE_UNSUPPORTED
#define GUPNP_DLNA_INT_VALUE_UNSUPPORTED
Static initializer for unsupported GUPnPDLNAIntValue. Can be used in two ways:
GUPnPDLNAIntValue value = GUPNP_DLNA_INT_VALUE_UNSUPPORTED;
or
return GUPNP_DLNA_INT_VALUE_UNSUPPORTED;
GUPNP_DLNA_STRING_VALUE_UNSET
#define GUPNP_DLNA_STRING_VALUE_UNSET
Static initializer for unset GUPnPDLNAStringValue. Can be used in two ways:
GUPnPDLNAStringValue value = GUPNP_DLNA_STRING_VALUE_UNSET;
or
return GUPNP_DLNA_STRING_VALUE_UNSET;
GUPNP_DLNA_STRING_VALUE_UNSUPPORTED
#define GUPNP_DLNA_STRING_VALUE_UNSUPPORTED
Static initializer for unsupported GUPnPDLNAStringValue. Can be used in two ways:
GUPnPDLNAStringValue value = GUPNP_DLNA_STRING_VALUE_UNSUPPORTED;
or
return GUPNP_DLNA_STRING_VALUE_UNSUPPORTED;
GUPnPDLNABoolValue
typedef struct { gboolean value; GUPnPDLNAValueState state; } GUPnPDLNABoolValue;
GUPnP DLNA Value representing a boolean value of some metadata attribute.
gboolean |
The boolean value. |
GUPnPDLNAValueState |
The state of GUPnPDLNABoolValue. |
GUPnPDLNAFractionValue
typedef struct { gint numerator; gint denominator; GUPnPDLNAValueState state; } GUPnPDLNAFractionValue;
GUPnP DLNA Value representing a fraction value of some metadata attribute.
gint |
The numerator of fraction. |
gint |
The denominator of fraction. |
GUPnPDLNAValueState |
The state of GUPnPDLNAFractionValue. |
GUPnPDLNAIntValue
typedef struct { gint value; GUPnPDLNAValueState state; } GUPnPDLNAIntValue;
GUPnP DLNA Value representing an integer value of some metadata attribute.
gint |
The integer value. |
GUPnPDLNAValueState |
The state of GUPnPDLNAIntValue. |
GUPnPDLNAStringValue
typedef struct { gchar *value; GUPnPDLNAValueState state; } GUPnPDLNAStringValue;
GUPnP DLNA Value representing a string value of some metadata attribute.
gchar * |
The string value. |
GUPnPDLNAValueState |
The state of GUPnPDLNAStringValue. |