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 Categories of advertising APIs and events 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. |