mme_metadata_extract_data()

Get the data format metadata from the metadata handle

Synopsis:

#include <mme/metadata.h>

const void *mme_metadata_extract_data( const mme_metadata_hdl_t *metadata,
                                       const char *type,
                                       uint32_t flags,
                                       size_t *length );

Arguments:

metadata
The pointer to the handle with the metadata.
type
The type of metadata to extract. See METADATA_*.
flags
For future use.
length
A pointer to the location to which the function should return the length, in bytes, of the extracted data. If there is no data, this value is 0 (zero).

Library:

metadata

Description:

The function mme_metadata_extract_data() returns the format of the metadata retrieved by mme_ms_metadata_get() and placed in the metadata handle mme_metadata_hdl_t. Metadata formats are defined by the METADATA_FORMAT_* enumerated values.

Events

None delivered.

Blocking and validation

This function validates that the metadata handle isn't NULL. It doesn't block.

Returns:

Data in the character string, or NULL if no data is found (errno is set).

Classification:

QNX Neutrino

Safety:
Interrupt handler No
Signal handler No
Thread Yes

See also:

METADATA_*, mme_metadata_alloc(), mme_metadata_extract_string(), mme_metadata_extract_unsigned(), mme_metadata_hdl_t, mme_ms_metadata_done(), mme_ms_metadata_get()