sensor_set_background()

#include <bps/sensor.h>
 

BPS_API int sensor_set_background(sensor_type_t type,
                                  bool enable_background)

Since:

BlackBerry 10.0.0

Arguments:

type

The sensor that should continue operation even in standby mode.

enable_background

If true the sensor continues operation while in standby. If false, the sensor stops operation while the system is in standby.

Library:

libbps (For the qcc command, use the -l bps option to link against this library)

Description:

The sensor_set_background() function when enabled allows the sensor to continue operation even when the system goes into standby mode.

If a sensor is set to stay active when the system is in standby mode, battery life is reduced.

Returns:

BPS_SUCCESS upon success, BPS_FAILURE with errno set otherwise.