bt_rdev_get_current_tx

Retrieve the current transmit (TX) power indicator of the connected remote Bluetooth-enabled device.

Synopsis:

#include <btapi/btdevice.h>

int bt_rdev_get_current_tx_power(const bt_remote_device_t *remote_device, int *tx_power)

Since:

BlackBerry 10.2.0

Arguments:

remote_device: A pointer to a remote device structure.

tx_power: A pointer to a buffer where the TX power value is to be written.

Library:

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

Description:

The current TX power value is only valid for a remote device that is currently connected to the BlackBerry. This function requests an updated TX power value for the current connection. The TX power value will be in the range -30 dB to +30 dB.

Returns:

0 is returned upon success, -1 with the errno set otherwise. Possible errno values include: