BLE_GAP_SetFilterAcceptList
C
uint16_t BLE_GAP_SetFilterAcceptList(uint8_t num, BLE_GAP_Addr_T *p_addr);
Description
Adds devices to the filter accept list.
Note
This API is not permitted under the following conditions:
If the advertising filter policy uses the filter accept list and advertising is enabled.
If the scanning filter policy uses the filter accept list and scanning is enabled.
If 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 size. |
[in] p_addr | Pointer to BLE_GAP_Addr_T structure buffer. |
Return values
Return value | Description |
---|---|
MBA_RES_SUCCESS | Successfully adds the device to the filter accept list. |
MBA_RES_OOM | Internal memory allocation failure occurred. |
MBA_RES_INVALID_PARA | Invalid parameters, such as if the address type does not match any of the Address types. |