1.2.2.1.1.4.53 BLE_GAP_SetFilterAcceptList
C
uint16_t BLE_GAP_SetFilterAcceptList(uint8_t num, BLE_GAP_Addr_T *p_addr);Description
Add devices to the filter accept list.
Note
This API is not permitted in the following three scenarios:
The advertising filter policy uses the filter accept list and advertising is enabled.
The scanning filter policy uses the filter accept list and scanning is enabled.
The initiator filter policy uses the filter accept list and a create connection command is outstanding.
Parameters
| Parameter | Description |
|---|---|
| [in] num | Number of address set. See Maximum filter accept list number. |
| [in] p_addr | Pointer to BLE_GAP_Addr_T structure buffer. |
Return values
| Return value | Description |
|---|---|
| MBA_RES_SUCCESS | Successfully add the device to the filter accept list. |
| MBA_RES_OOM | Internal memory allocation failure. |
| MBA_RES_INVALID_PARA | Invalid parameters, if address type does not match any of the Address type. |