说明

GetLocalAddress 命令负责查询本地蓝牙设备的蓝牙设备地址。此函数在成功执行时返回零，而在出现任何错误时返回负值。必须存在蓝牙协议栈 ID，才能尝试调用此命令。

参数

使用此命令时不需要包含参数。参数对查询的结果没有影响。

可能的返回值

• (0) 成功查询本地地址
• (-1) BTPS_ERROR_INVALID_PARAMETER
• (-2) BTPS_ERROR_INVALID_BLUETOOTH_STACK_ID
• (-4) FUNCTION_ERROR
• (-8) INVALID_STACK_ID_ERROR

API 调用

GAP_Query_Local_BD_ADDR(BluetoothStackID, &BD_ADDR)

API 原型

int BTPSAPI GAP_Query_Local_BD_ADDR(unsigned int BluetoothStackID, BD_ADDR_t *BD_ADDR)

API 说明

此函数负责查询（和报告）本地蓝牙设备的设备地址。第二个参数是指向缓冲区的指针，该缓冲区用于接收本地蓝牙设备的设备地址。如果该函数成功，则 BD_ADDR 参数指向的缓冲区将填充从本地蓝牙设备读取的设备地址。如果此函数返回负值，则无法查询本地蓝牙设备的设备地址（错误情况）。