BLE_GAP_ExtCreateConnection

C

uint16_t BLE_GAP_ExtCreateConnection(uint8_t filterPolicy, BLE_GAP_Addr_T *p_peerAddr, BLE_GAP_ExtCreateConnPhy_T *p_createConnPhy);

Initiates a BLE connection using the extended advertising feature set.

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 Categories of advertising APIs and events for advertising API details. Initialization with both BLE_GAP_ConnCentralInit and BLE_GAP_ExtConnCentralInit is required before using this API.

BLE_GAP_EVT_CONNECTED is generated when the connection is established.


Parameter	Description
[in] filterPolicy	Determines whether the filter accept list is used. See Initiator filter policy 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 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.