Get device configuration information
#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 );
- 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.
mme
The function mme_device_get_config() retrieves device configuration information for a specified device accessed through MediaFS.
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:
- If the value returned by mme_device_get_config() is less than or equal to (≤) the buffer length (buflen), the buffer was long enough for the requested information. The function wrote the information to the buffer and you can go on to the next operation.
- If the value returned by mme_device_get_config() is greater than (>) the buffer length (buflen), the buffer was too small for the requested information. You need to increase the buffer length to at least the returned value and call mme_device_get_config() again.
 |
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
|
None delivered.
This function perfoms no validations and runs to completion.
- >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).
QNX Neutrino
Safety: | |
Interrupt handler |
No |
Signal handler |
No |
Thread |
Yes |
mm_media_status_t,
mme_device_set_config()