BLE_GAP_ExtCreateConnection
C
uint16_t BLE_GAP_ExtCreateConnection(uint8_t filterPolicy, BLE_GAP_Addr_T *p_peerAddr, BLE_GAP_ExtCreateConnPhy_T *p_createConnPhy);Description
Initiates a BLE connection using the extended advertising feature set.
Note
This API is part of the extended advertising feature set and will be disallowed if any legacy advertising feature API has been used prior to this call. See BLE_GAP_ADV_CATS for advertising API details. Initialization with both BLE_GAP_ConnCentralInit and BLE_GAP_ExtConnCentralInit is required before using this API.
Events generated
BLE_GAP_EVT_CONNECTED is generated when the connection is established.
Parameters
| Parameter | Description |
|---|---|
| [in] filterPolicy | Determines whether the filter accept list is used. See Initiator filter policies for details. |
| [in] p_peerAddr | Pointer to the structure containing the remote Bluetooth address and address type. See BLE_GAP_Addr_T. |
| [in] p_createConnPhy | Pointer to the structure containing the connection PHY parameters. See BLE_GAP_ExtCreateConnPhy_T. |
Return values
| Return value | Description |
|---|---|
| MBA_RES_SUCCESS | Successfully initiates the create connection process. |
| MBA_RES_OOM | Internal memory allocation failure occurred. |
| MBA_RES_INVALID_PARA | The parameters provided are invalid. |
| MBA_RES_COMMAND_DISALLOWED | Command disallowed due to a conflicting operation or state. |