1.2.2.1.1.4.49 BLE_GAP_SetExtAdvParams

C

uint16_t BLE_GAP_SetExtAdvParams(BLE_GAP_ExtAdvParams_T *p_extAdvParams, int8_t *p_selectedTxPower);

Description

Configure the extended advertising parameters.

Note

This API belongs to extended advertising feature. It will be disallowed if any one API belongs legacy advertising feature is issued before. Categories of advertising APIs and events for details of advertising APIs.

BLE_GAP_AdvInit and BLE_GAP_ExtAdvInit are required for this API.

Parameters


Parameter	Description
[in] p_extAdvParams	Pointer to BLE_GAP_ExtAdvParams_T structure buffer.
[out] p_selectedTxPower	Point to the real transmit power level. (Unit: dBm)

Return values


Return value	Description
MBA_RES_SUCCESS	Successfully configure the extended advertising parameters.
MBA_RES_OOM	Internal memory allocation failure.
MBA_RES_INVALID_PARA	Invalid parameters.
MBA_RES_COMMAND_DISALLOWED	Command disallowed.