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. |