1.2.2.1.1.4.51 BLE_GAP_SetExtScanningParams
C
uint16_t BLE_GAP_SetExtScanningParams(uint8_t filterPolicy, BLE_GAP_ExtScanningPhy_T *p_extScanPhy);
Description
Set the extended scan parameters to be used on the advertising physical channels.
Note
This API belongs to extended advertising feature. It will be disallowed if any one API that belongs to legacy advertising feature is issued before. Categories of advertising APIs and events for details of advertising APIs.
BLE_GAP_ScanInit and BLE_GAP_ExtScanInit are required for this API.
Parameters
Parameter | Description |
---|---|
[in] filterPolicy | Scanning filter policy. See Scan filter policy. |
[in] p_extScanPhy | Pointer to BLE_GAP_ExtScanningPhy_T structure buffer. |
Return values
Return value | Description |
---|---|
MBA_RES_SUCCESS | Successfully set the extended scan parameters. |
MBA_RES_OOM | Internal memory allocation failure. |
MBA_RES_INVALID_PARA | Invalid parameters. |
MBA_RES_COMMAND_DISALLOWED | Command disallowed. |