This is called by #GUPnPDLNAProfileGuesser to get a bitrate. A bitrate. A #GUPnPDLNAAudioInformation object. This is called by #GUPnPDLNAProfileGuesser to get a channels count. A number of channels. A #GUPnPDLNAAudioInformation object. This is called by #GUPnPDLNAProfileGuesser to get a depth. A depth. A #GUPnPDLNAAudioInformation object. This is called by #GUPnPDLNAProfileGuesser to get a layer. A layer. A #GUPnPDLNAAudioInformation object. This is called by #GUPnPDLNAProfileGuesser to get a level. A level. A #GUPnPDLNAAudioInformation object. This is called by #GUPnPDLNAProfileGuesser to get a MIME type. A MIME type. A #GUPnPDLNAAudioInformation object. This is called by #GUPnPDLNAProfileGuesser to get an MPEG audio version. An MPEG audio version. A #GUPnPDLNAAudioInformation object. This is called by #GUPnPDLNAProfileGuesser to get an MPEG version. An MPEG version. A #GUPnPDLNAAudioInformation object. This is called by #GUPnPDLNAProfileGuesser to get a profile. A profile. A #GUPnPDLNAAudioInformation object. This is called by #GUPnPDLNAProfileGuesser to get a sample rate. A sample rate. A #GUPnPDLNAAudioInformation object. This is called by #GUPnPDLNAProfileGuesser to get a stream format. A stream format. A #GUPnPDLNAAudioInformation object. This is called by #GUPnPDLNAProfileGuesser to get a WMA version. A WMA version. A #GUPnPDLNAAudioInformation object. A bitrate. A #GUPnPDLNAAudioInformation object. A number of channels. A #GUPnPDLNAAudioInformation object. A depth. A #GUPnPDLNAAudioInformation object. A layer. A #GUPnPDLNAAudioInformation object. A level. A #GUPnPDLNAAudioInformation object. A MIME type. A #GUPnPDLNAAudioInformation object. An MPEG audio version. A #GUPnPDLNAAudioInformation object. An MPEG version. A #GUPnPDLNAAudioInformation object. A profile. A #GUPnPDLNAAudioInformation object. A sample rate. A #GUPnPDLNAAudioInformation object. A stream format. A #GUPnPDLNAAudioInformation object. A WMA version. A #GUPnPDLNAAudioInformation object. Parent class. This is called by #GUPnPDLNAProfileGuesser to get a bitrate. A bitrate. A #GUPnPDLNAAudioInformation object. This is called by #GUPnPDLNAProfileGuesser to get a channels count. A number of channels. A #GUPnPDLNAAudioInformation object. This is called by #GUPnPDLNAProfileGuesser to get a depth. A depth. A #GUPnPDLNAAudioInformation object. This is called by #GUPnPDLNAProfileGuesser to get a layer. A layer. A #GUPnPDLNAAudioInformation object. This is called by #GUPnPDLNAProfileGuesser to get a level. A level. A #GUPnPDLNAAudioInformation object. This is called by #GUPnPDLNAProfileGuesser to get an MPEG audio version. An MPEG audio version. A #GUPnPDLNAAudioInformation object. This is called by #GUPnPDLNAProfileGuesser to get an MPEG version. An MPEG version. A #GUPnPDLNAAudioInformation object. This is called by #GUPnPDLNAProfileGuesser to get a profile. A profile. A #GUPnPDLNAAudioInformation object. This is called by #GUPnPDLNAProfileGuesser to get a sample rate. A sample rate. A #GUPnPDLNAAudioInformation object. This is called by #GUPnPDLNAProfileGuesser to get a stream format. A stream format. A #GUPnPDLNAAudioInformation object. This is called by #GUPnPDLNAProfileGuesser to get a WMA version. A WMA version. A #GUPnPDLNAAudioInformation object. This is called by #GUPnPDLNAProfileGuesser to get a MIME type. A MIME type. A #GUPnPDLNAAudioInformation object. Padding. Ignore it. GUPnP DLNA Value representing a boolean value of some metadata attribute. The boolean value. The state of #GUPnPDLNABoolValue. This is called by #GUPnPDLNAProfileGuesser to get a MIME type. A MIME type. A #GUPnPDLNAContainerInformation object. This is called by #GUPnPDLNAProfileGuesser to get an MPEG version. An MPEG version. A #GUPnPDLNAContainerInformation object. This is called by #GUPnPDLNAProfileGuesser to get a packet size. A packet size. A #GUPnPDLNAContainerInformation object. This is called by #GUPnPDLNAProfileGuesser to get a profile. A profile. A #GUPnPDLNAContainerInformation object. This is called by #GUPnPDLNAProfileGuesser to get a variant. A variant. A #GUPnPDLNAContainerInformation object. This is called by #GUPnPDLNAProfileGuesser to get whether it is a system stream Whether it is system stream. A #GUPnPDLNAContainerInformation object. A MIME type. A #GUPnPDLNAContainerInformation object. An MPEG version. A #GUPnPDLNAContainerInformation object. A packet size. A #GUPnPDLNAContainerInformation object. A profile. A #GUPnPDLNAContainerInformation object. A variant. A #GUPnPDLNAContainerInformation object. Whether it is system stream. A #GUPnPDLNAContainerInformation object. Parent class. This is called by #GUPnPDLNAProfileGuesser to get an MPEG version. An MPEG version. A #GUPnPDLNAContainerInformation object. This is called by #GUPnPDLNAProfileGuesser to get a packet size. A packet size. A #GUPnPDLNAContainerInformation object. This is called by #GUPnPDLNAProfileGuesser to get a profile. A profile. A #GUPnPDLNAContainerInformation object. This is called by #GUPnPDLNAProfileGuesser to get whether it is a system stream Whether it is system stream. A #GUPnPDLNAContainerInformation object. This is called by #GUPnPDLNAProfileGuesser to get a variant. A variant. A #GUPnPDLNAContainerInformation object. This is called by #GUPnPDLNAProfileGuesser to get a MIME type. A MIME type. A #GUPnPDLNAContainerInformation object. Padding. Ignore it. A copy of @fraction. A fraction to copy. Frees @fraction. A fraction to free. @fraction's denominator. A fraction. @fraction's numerator. A fraction. A copy of @range. A range to copy. Frees @range. A range to free. Maximum value of @range. A range. Minimum value of @range. A range. GUPnP DLNA Value representing a fraction value of some metadata attribute. The numerator of fraction. The denominator of fraction. The state of #GUPnPDLNAFractionValue. This is called by #GUPnPDLNAProfileGuesser to get a depth. A depth of an image. A #GUPnPDLNAImageInformation object. This is called by #GUPnPDLNAProfileGuesser to get a height. A height of an image. A #GUPnPDLNAImageInformation object. This is called by #GUPnPDLNAProfileGuesser to get a MIME type. A MIME type of an image. A #GUPnPDLNAImageInformation object. This is called by #GUPnPDLNAProfileGuesser to get a width. A width of an image. A #GUPnPDLNAImageInformation object. A depth of an image. A #GUPnPDLNAImageInformation object. A height of an image. A #GUPnPDLNAImageInformation object. A MIME type of an image. A #GUPnPDLNAImageInformation object. A width of an image. A #GUPnPDLNAImageInformation object. Parent class. This is called by #GUPnPDLNAProfileGuesser to get a depth. A depth of an image. A #GUPnPDLNAImageInformation object. This is called by #GUPnPDLNAProfileGuesser to get a height. A height of an image. A #GUPnPDLNAImageInformation object. This is called by #GUPnPDLNAProfileGuesser to get a width. A width of an image. A #GUPnPDLNAImageInformation object. This is called by #GUPnPDLNAProfileGuesser to get a MIME type. A MIME type of an image. A #GUPnPDLNAImageInformation object. Padding. Ignore it. Get an audio information of media file if applicable (e.g. for video and audio files). A #GUPnPDLNAAudioInformation object or %NULL. A #GUPnPDLNAInformation object. Get an container information of media file if applicable (e.g. for video and audio files). A #GUPnPDLNAContainerInformation object or %NULL. A #GUPnPDLNAInformation object. Get an container information of media file if applicable (e.g. for image files). A #GUPnPDLNAImageInformation object or %NULL. A #GUPnPDLNAInformation object. This is called by #GUPnPDLNAProfileGuesser to get the name of the DLNA profile assigned with this information. The name of a DLNA profile or %NULL. A #GUPnPDLNAInformation object. Get an container information of media file if applicable (e.g. for video files). A #GUPnPDLNAVideoInformation object or %NULL. A #GUPnPDLNAInformation object. Get an audio information of media file if applicable (e.g. for video and audio files). A #GUPnPDLNAAudioInformation object or %NULL. A #GUPnPDLNAInformation object. Get an container information of media file if applicable (e.g. for video and audio files). A #GUPnPDLNAContainerInformation object or %NULL. A #GUPnPDLNAInformation object. Get an container information of media file if applicable (e.g. for image files). A #GUPnPDLNAImageInformation object or %NULL. A #GUPnPDLNAInformation object. The name of a DLNA profile or %NULL. A #GUPnPDLNAInformation object. An URI of a file. A #GUPnPDLNAInformation object. Get an container information of media file if applicable (e.g. for video files). A #GUPnPDLNAVideoInformation object or %NULL. A #GUPnPDLNAInformation object. Audio information of a file. Container information of a file. Image information of a file. URI of file which metadata this object stores. Video information of a file. Parent class. This is called by #GUPnPDLNAProfileGuesser to get an audio information. A #GUPnPDLNAAudioInformation object or %NULL. A #GUPnPDLNAInformation object. This is called by #GUPnPDLNAProfileGuesser to get a container information. A #GUPnPDLNAContainerInformation object or %NULL. A #GUPnPDLNAInformation object. This is called by #GUPnPDLNAProfileGuesser to get an image information. A #GUPnPDLNAImageInformation object or %NULL. A #GUPnPDLNAInformation object. This is called by #GUPnPDLNAProfileGuesser to get a video information. A #GUPnPDLNAVideoInformation object or %NULL. A #GUPnPDLNAInformation object. This is called by #GUPnPDLNAProfileGuesser to get the name of the DLNA profile assigned with this information. The name of a DLNA profile or %NULL. A #GUPnPDLNAInformation object. Padding. Ignore it. A copy of @range. A range to copy. Frees @range. A range to free. Maximum value of @range. A range. Minimum value of @range. A range. GUPnP DLNA Value representing an integer value of some metadata attribute. The integer value. The state of #GUPnPDLNAIntValue. Queues @uri for metadata discovery. When discovery is completed, the ::done signal is emitted on @extractor. %TRUE if @uri was successfully queued, %FALSE otherwise. #GUPnPDLNAMetadataExtractor object to use for discovery URI to gather metadata for Timeout in miliseconds. Discovers synchronously metadata of given @uri. A #GUPnPDLNAInformation object if discovery succeeded, otherwise %NULL. #GUPnPDLNAMetadataExtractor object to use for discovery URI to gather metadata for Timeout in miliseconds. Emits ::done signal. This function is intended to be used by subclasses of #GUPnPDLNAMetadataExtractor. It is required to always pass a meaningful @info, even in case of error. That way a receiver of this signal can know which URI discovery failed by using gupnp_dlna_information_get_uri(). A #GUPnPDLNAMetadataExtractor object. A #GUPnPDLNAInformation about discovered URI. A #GError. Queues @uri for metadata discovery. When discovery is completed, the ::done signal is emitted on @extractor. %TRUE if @uri was successfully queued, %FALSE otherwise. #GUPnPDLNAMetadataExtractor object to use for discovery URI to gather metadata for Timeout in miliseconds. Discovers synchronously metadata of given @uri. A #GUPnPDLNAInformation object if discovery succeeded, otherwise %NULL. #GUPnPDLNAMetadataExtractor object to use for discovery URI to gather metadata for Timeout in miliseconds. Will be emitted when all information on a URI could be discovered. The results as #GUPnPDLNAInformation. Contains details of the error if discovery fails, otherwise is %NULL. Parent class. This is called by #GUPnPDLNAProfileGuesser to get a information about media file asynchronously. %TRUE if @uri was successfully queued, %FALSE otherwise. #GUPnPDLNAMetadataExtractor object to use for discovery URI to gather metadata for Timeout in miliseconds. This is called by #GUPnPDLNAProfileGuesser to get a information about media file synchronously. A #GUPnPDLNAInformation object if discovery succeeded, otherwise %NULL. #GUPnPDLNAMetadataExtractor object to use for discovery URI to gather metadata for Timeout in miliseconds. Padding. Ignore it. The top-level object used for the in-memory representation of the DLNA Profiles. Gets a list of audio restrictions. Audio restrictions. Do not modify. A profile. Gets a list of container restrictions. Container restrictions. Do not modify. A profile. %TRUE if @profile is extended one and %FALSE otherwise. The #GUPnPDLNAProfile object. Gets a list of image restrictions. Image restrictions. Do not modify. A profile. The DLNA MIME type of the DLNA profile represented by @profile. The #GUPnPDLNAProfile object. The name of the DLNA profile represented by @profile. The #GUPnPDLNAProfile object. Gets a list of video restrictions. Video restrictions. Do not modify. A profile. Whether the DLNA profile is not a part of DLNA specification. MIME type of the DLNA profile. Name of the DLNA profile. A #GObjectClass - parent of this class. Creates a new guesser that will use specific DLNA profiles for matching - i.e. which profiles will be used depends on @relaxed_mode and @extended_mode. A new #GUPnPDLNAProfileGuesser object. %TRUE to enable relaxed mode support. %FALSE otherwise. %TRUE to enable extended mode support. %FALSE otherwise. Cleans up the DLNA profiles. Provided to remove Valgrind noise. Not thread-safe. Do not call it if there is even a slightest chance that profile guessing will be performed during process lifetime. The profiles are not reloaded after cleanup. %TRUE if @guesser is in extended mode, %FALSE otherwise. The #GUPnPDLNAProfileGuesser object. Lookups for #GUPnPDLNAProfile with given @name. A #GUPnPDLNAProfile object on success, %NULL otherwise. The #GUPnPDLNAProfileGuesser object. The name of the DLNA profile to be retrieved. %TRUE if @guesser is in relaxed mode, %FALSE otherwise. The #GUPnPDLNAProfileGuesser object. Asynchronously guesses DLNA profile for given @uri. When guessing is done, ::done signal is emitted on @guesser. %TRUE if @uri was successfully queued, %FALSE otherwise. #GUPnPDLNAProfileGuesser object to use for guessing. URI of media. Timeout of guessing in miliseconds. Guesses the profile which fits to passed @info. A #GUPnPDLNAProfile object on success, %NULL otherwise. The #GUPnPDLNAProfileGuesser object. The #GUPnPDLNAInformation object. Synchronously guesses DLNA profile for given @uri. DLNA profile if any had matched, %NULL otherwise. #GUPnPDLNAProfileGuesser object to use for guessing. URI of media. Timeout of guessing in miliseconds. A place where to store DLNA information or %NULL. Gets a list of the all DLNA profiles supported by @guesser. A #GList of #GUPnPDLNAProfile on success, %NULL otherwise. The #GUPnPDLNAProfileGuesser whose profile list is required. Whether profile matching should be done also against DLNA profiles not being a part of DLNA specification. Whether profile matching should not be strictly compliant with the DLNA specification. Will be emitted when guessing DLNA profile for a URI has finished. URI metadata as #GUPnPDLNAInformation. The results as #GUPnPDLNAProfile. Contains details of the error if discovery failed, else is %NULL. A #GObjectClass - parent of this class. A copy of @restriction. A restriction to copy. Frees @restriction. A restriction to free. Gets @restriction's entries. It is a string to #GUPnPDLNAValueList mapping. Entries. Do not modify. A restriction. Gets @restriction's MIME type. MIME type. Do not modify. A restriction. %TRUE if @restriction is empty and has no MIME type, otherwise %FALSE. A restriction. Creates a string representation of @restriction. A string representation of @restriction. Free with g_free() when not needed. A restriction. GUPnP DLNA Value representing a string value of some metadata attribute. The string value. The state of #GUPnPDLNAStringValue. A copy of @list. A list to copy. Frees the value list. A list to free. Gets a list of #GValues. #GValues can be of types #G_TYPE_BOOLEAN, #G_TYPE_INT, #G_TYPE_STRING, #GUPNP_TYPE_DLNA_FRACTION, #GUPNP_TYPE_DLNA_FRACTION_RANGE or #GUPNP_TYPE_DLNA_INT_RANGE. A list. Free it with g_list_free_full() with g_free(). A list. %TRUE if @list is empty, otherwise %FALSE. A list. Creates a string representation of @list. A string representation of @list. Free with g_free() when not needed. A list. Flags describing a state of GUPnP DLNA Value. Value is set. Value is unset. Value is unsupported. This is called by #GUPnPDLNAProfileGuesser to get a bitrate. A bitrate. A #GUPnPDLNAVideoInformation object. This is called by #GUPnPDLNAProfileGuesser to get a framerate. A framerate. A #GUPnPDLNAVideoInformation object. This is called by #GUPnPDLNAProfileGuesser to get a height. A height. A #GUPnPDLNAVideoInformation object. This is called by #GUPnPDLNAProfileGuesser to get a level. A level. A #GUPnPDLNAVideoInformation object. This is called by #GUPnPDLNAProfileGuesser to get a MIME type. A MIME type. A #GUPnPDLNAVideoInformation object. This is called by #GUPnPDLNAProfileGuesser to get an MPEG version. An MPEG version. A #GUPnPDLNAVideoInformation object. This is called by #GUPnPDLNAProfileGuesser to get a pixel-aspect-ratio. A pixel-aspect-ratio. A #GUPnPDLNAVideoInformation object. This is called by #GUPnPDLNAProfileGuesser to get a profile. A profile. A #GUPnPDLNAVideoInformation object. This is called by #GUPnPDLNAProfileGuesser to get a width. A width. A #GUPnPDLNAVideoInformation object. This is called by #GUPnPDLNAProfileGuesser to get whether it is interlaced. Whether video is interlaced. A #GUPnPDLNAVideoInformation object. This is called by #GUPnPDLNAProfileGuesser to get whether it is a system stream. Whether it is a system stream. A #GUPnPDLNAVideoInformation object. A bitrate. A #GUPnPDLNAVideoInformation object. A framerate. A #GUPnPDLNAVideoInformation object. A height. A #GUPnPDLNAVideoInformation object. A level. A #GUPnPDLNAVideoInformation object. A MIME type. A #GUPnPDLNAVideoInformation object. An MPEG version. A #GUPnPDLNAVideoInformation object. A pixel-aspect-ratio. A #GUPnPDLNAVideoInformation object. A profile. A #GUPnPDLNAVideoInformation object. A width. A #GUPnPDLNAVideoInformation object. Whether video is interlaced. A #GUPnPDLNAVideoInformation object. Whether it is a system stream. A #GUPnPDLNAVideoInformation object. Parent class. This is called by #GUPnPDLNAProfileGuesser to get a bitrate. A bitrate. A #GUPnPDLNAVideoInformation object. This is called by #GUPnPDLNAProfileGuesser to get a framerate. A framerate. A #GUPnPDLNAVideoInformation object. This is called by #GUPnPDLNAProfileGuesser to get a height. A height. A #GUPnPDLNAVideoInformation object. This is called by #GUPnPDLNAProfileGuesser to get whether it is interlaced. Whether video is interlaced. A #GUPnPDLNAVideoInformation object. This is called by #GUPnPDLNAProfileGuesser to get a level. A level. A #GUPnPDLNAVideoInformation object. This is called by #GUPnPDLNAProfileGuesser to get an MPEG version. An MPEG version. A #GUPnPDLNAVideoInformation object. This is called by #GUPnPDLNAProfileGuesser to get a pixel-aspect-ratio. A pixel-aspect-ratio. A #GUPnPDLNAVideoInformation object. This is called by #GUPnPDLNAProfileGuesser to get a profile. A profile. A #GUPnPDLNAVideoInformation object. This is called by #GUPnPDLNAProfileGuesser to get whether it is a system stream. Whether it is a system stream. A #GUPnPDLNAVideoInformation object. This is called by #GUPnPDLNAProfileGuesser to get a width. A width. A #GUPnPDLNAVideoInformation object. This is called by #GUPnPDLNAProfileGuesser to get a MIME type. A MIME type. A #GUPnPDLNAVideoInformation object. Padding. Ignore it. #GUPnPDLNAAudioInformation holds all audio metadatas important for matching profiles. Note that it does not mean all data should be provided for every audio file as in some cases it does not make sense (e.g. WMA version does not make sense for MPEG audio files). For metadata attributes that do not exist in current audio file an unset value should be returned. For metadata attributes that do exist a set value with proper underlying value should be returned. In case metadata extractor has completely no clue how to extract some metadata attribute at all, an unsupported value should be returned. Note that unsupported values should be a temporary mean before fixing the multimedia framework to be able to extract such attribute. Note that gupnp_dlna_audio_information_get_mime() should always return a set value. Otherwise it is highly probably that the file will not match against any DLNA profile. #GUPnPDLNAContainerInformation holds all container metadatas important for matching profiles. Note that it does not mean all data should be provided for every media file as in some cases it does not make sense (e.g. MPEG version does not make sense for WMA media files). For metadata attributes that do not exist in current media file an unset value should be returned. For metadata attributes that do exist a set value with proper underlying value should be returned. In case metadata extractor has completely no clue how to extract some metadata attribute at all, an unsupported value should be returned. Note that unsupported values should be a temporary mean before fixing the multimedia framework to be able to extract such attribute. Note that gupnp_dlna_container_information_get_mime() should always return a set value. Otherwise it is highly probably that the file will not match against any DLNA profile. #GUPnPDLNAImageInformation holds all image metadatas important for matching profiles. Note that it does not mean all data should be provided for every image file as in some cases it does not make sense. For metadata attributes that do not exist in current image file an unset value should be returned. For metadata attributes that do exist a set value with proper underlying value should be returned. In case metadata extractor has completely no clue how to extract some metadata attribute at all, an unsupported value should be returned. Note that unsupported values should be a temporary mean before fixing the multimedia framework to be able to extract such attribute. Note that gupnp_dlna_image_information_get_mime() should always return a set value. Otherwise it is highly probably that the file will not match against any DLNA profile. Subclasses of #GUPnPDLNAInformation should override all virtual functions provided by this class. The overrides should return a subclasses of specific information base classes. When instantiating a subclass of #GUPnPDLNAInformation make sure that "uri" with a URI to media file is passed to g_object_new(). #GUPnPDLNAMetadataExtractor is used by #GUPnPDLNAProfileGuesser to get needed metadata for profile matching. This class itself does not implement any metadata extraction features. For that it is expected to provide a plugin which: - Provides a #GUPnPDLNAMetadataExtractor subclass implementation. - Exports a <function>gupnp_dlna_get_default_extractor</function>() which takes no parameters and returns a #GUPnPDLNAMetadataExtractor. #GModule is used for loading the plugin, so #GModule's features can be used also (like exporting <function>g_module_check_init</function>() to initialize the multimedia framework used for extracting metadata). Default plugin directory and default plugin file is set during configuration stage, but it can be overriden during runtime by setting respectively <envar>GUPNP_DLNA_METADATA_BACKEND</envar> and <envar>GUPNP_DLNA_METADATA_BACKEND_DIR</envar> environment variables before the plugin is loaded (i.e. before #GUPnPDLNAProfileGuesser is used for guessing profile). The <envar>GUPNP_DLNA_METADATA_BACKEND</envar> environment variable should hold a name like <userinput>"gstreamer"</userinput>, so <filename>libgstreamer.so</filename> will be loaded. For determining a plugin filename g_module_build_path() is used. If subclassing #GUPnPDLNAMetadataExtractor then also #GUPnPDLNAInformation, #GUPnPDLNAAudioInformation, #GUPnPDLNAContainerInformation, #GUPnPDLNAImageInformation and #GUPnPDLNAVideoInformation have to be subclassed as well. The #GUPnPDLNAProfileGuesser object provides a few APIs that return #GUPnPDLNAProfile objects. These represent a single DLNA profile. Each #GUPnPDLNAProfile has a name (the name of the DLNA profile) and the corresponding MIME type. Public representation of the various audio/container/image/video restrictions specified for that DLNA profile is to be added. The API provides synchronous and asynchronous guessing of DLNA profile. The asynchronous mode requires a running #GMainLoop in the default #GMainContext. 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. #GUPnPDLNAVideoInformation holds all video metadatas important for matching profiles. Note that it does not mean all data should be provided for every video file as in some cases it does not make sense (e.g. MPEG version does not make sense for Quicktime video files). For metadata attributes that do not exist in current video file an unset value should be returned. For metadata attributes that do exist a set value with proper underlying value should be returned. In case metadata extractor has completely no clue how to extract some metadata attribute at all, an unsupported value should be returned. Note that unsupported values should be a temporary mean before fixing the multimedia framework to be able to extract such attribute. Note that gupnp_dlna_video_information_get_mime() should always return a set value. Otherwise it is highly probably that the file will not match against any DLNA profile.