mme_device_get_config()

Get device configuration information

Synopsis:

#include <mme/mme.h>

int mme_device_get_config( mme_hdl_t  *hdl,
                           uint64_t msid,
                           const char *xpath,
                           unsigned flags,
                           unsigned buflen,
                           char *buffer );

Arguments:

hdl
An MME connection handle.
msid
The mediastore ID of the device from which option information is required.
xpath
A pointer to the xpath of the XML element attribute to retrieve. This xpath must be the string "/" (Get all option configuration information).
flags
Flags to detemine the behavior of the operation. For future use.
buflen
The length of the buffer (referred to by buffer) for the device configuration.
buffer
A pointer to the buffer where the option option values are placed. See Getting and setting device configuration values in the MME Developer's Guide chapter External Devices, CD Changers and Streamed Media.

Library:

mme

Description:

The function mme_device_get_config() retrieves device configuration information for a specified device accessed through MediaFS.

Ensuring an adequate buffer length

The function mme_device_get_config() returns a buffer length when it successfully completes execution. This buffer length indicates only that the function did not fail. It does not indicate that the configuration information was successfully written to the buffer referenced by the buffer argument:


Note: At present, mme_device_get_config() only supports:
  • the following devices accessed through MediaFS:
    • iPod devices
    • Bluetooth devices using a Temic stack
  • retrieving all option configuration information; individual elements or attributes can not be specified

Events

None delivered.

Blocking and validation

This function perfoms no validations and runs to completion.

Returns:

>0
The function completed successfully, but did not necessarily retrieve the requested information. See Ensuring an adequate buffer length above.
-1
An error occured (errno is set).

Classification:

QNX Neutrino

Safety:
Interrupt handler No
Signal handler No
Thread Yes

See also:

mm_media_status_t, mme_device_set_config()