BLE_GAP_UpdateConnParam
C
uint16_t BLE_GAP_UpdateConnParam(uint16_t connHandle, BLE_GAP_ConnParams_T *p_connParams);
Description
Updates connection parameters for an existing connection.
Note
This command should only be used after the BLE_GAP_EVT_FEATURE_EXCHANGE_COMPL event has been received.
Events generated
BLE_GAP_EVT_CONN_PARAM_UPDATE is generated when the connection parameters update is complete.
Parameters
Parameter | Description |
---|---|
[in] connHandle | Connection handle associated with this connection. |
[in] p_connParams | Pointer to the BLE_GAP_ConnParams_T structure containing the new parameters. |
Return values
Return value | Description |
---|---|
MBA_RES_SUCCESS | Successfully updates the connection parameters. |
MBA_RES_FAIL | Connection update is in progress. |
MBA_RES_OOM | Internal memory allocation failure occurred. |
MBA_RES_INVALID_PARA | Invalid parameters, or if any of the connection update parameters are out of range (see Connection parameters range ), or if the connection with the specified handle does not exist. |
MBA_RES_UNSUPPORT_REMOTE_FEATURE | Unsupported remote feature. |