BLE_GAP_SetExtScanningParams

C

uint16_t BLE_GAP_SetExtScanningParams(uint8_t filterPolicy, BLE_GAP_ExtScanningPhy_T *p_extScanPhy);

Description

Sets the extended scan parameters for advertising physical channels.

Note

This API is part of the extended advertising feature and is disallowed if any legacy advertising feature API has been used previously. See BLE_GAP_ADV_CATS for details on advertising APIs. Initialization with BLE_GAP_ScanInit and BLE_GAP_ExtScanInit is required before using this API.

Parameters


Parameter	Description
[in] filterPolicy	Scanning filter policy. Refer to Scan filter policies for possible values.
[in] p_extScanPhy	Pointer to a BLE_GAP_ExtScanningPhy_T structure containing the scan parameters.

Return values


Return value	Description
MBA_RES_SUCCESS	Successfully sets the extended scan parameters.
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.