mme_device_set_config()

Set device options

Synopsis:

#include <mme/mme.h>

int mme_device_set_config( mme_hdl_t *hdl,
                           uint64_t msid,
                           const char *xpath,
                           const char *newvalue,
                           unsigned flags );

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 set. This xpath must specify an XML element attribute; for example: "/path/to/node@value".
newvalue
A pointer to the new value for the specified option.
flags
Flags to detemine the behavior of the operation. For future use.

Library:

mme

Description:

The function mme_device_set_config() sets a device configuration attribute for a specified device accessed through MediaFS.


Note: As of this release, mme_device_set_config() only supports:
  • iPod devices accessed through MediaFS
  • setting a single option configuration attribute; you must call the function for each attribute you want to change

For more information, see Getting and setting device configuration values in the MME Developer's Guide chapter External Devices, CD Changers and Streamed Media.

Events

None delivered.

Blocking and validation

This function performs no validations. It does not block.

Returns:

0
Success.
-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_get_config()