说明

StartScanning 命令负责启动 LE 扫描过程。如果成功，此命令将返回零；如果发生错误，则返回负值。该命令调用用于执行扫描的 StartScan（在 BluetoothStackID 中未签名）函数。

参数

使用此命令时不需要包含参数。参数对扫描的结果没有影响。

可能的返回值

• (0) 成功启动了 LE 扫描过程
• (-1)蓝牙协议栈 ID 在 StartScan() 调用期间无效
• (-4) FUNCTION_ERROR
• (-8) INVALID_STACK_ID_ERROR
• (-2) BTPS_ERROR_INVALID_BLUETOOTH_STACK_ID
• (-1) BTPS_ERROR_INVALID_PARAMETER
• (-66) BTPS_ERROR_INSUFFICIENT_RESOURCES
• (-105) BTPS_ERROR_SCAN_ACTIVE
• (-56) BTPS_ERROR_GAP_NOT_INITIALIZED
• (-104) BTPS_ERROR_LOCAL_CONTROLLER_DOES_NOT_SUPPORT_LE
• (-57) BTPS_ERROR_DEVICE_HCI_ERROR

API 调用

GAP_LE_Perform_Scan(BluetoothStackID, stActive, 10, 10, latPublic, fpNoFilter, TRUE, GAP_LE_Event_Callback, 0)

API 原型

int BTPSAPI GAP_LE_Perform_Scan(unsigned int BluetoothStackID, GAP_LE_Scan_Type_t ScanType, unsigned int ScanInterval, unsigned int ScanWindow,GAP_LE_Address_Type_t LocalAddressType, GAP_LE_Filter_Policy_t FilterPolicy, Boolean_t FilterDuplicates, GAP_LE_Event_Callback_t GAP_LE_Event_Callback, unsignedlong CallbackParameter)

API 说明

提供 GAP_LE_Perform_Scan 函数是为了让本地主机能够开始 LE 扫描过程。此过程在概念上类似于蓝牙 BR/EDR 中的查询过程，因为这可用于发现已被指示进行广播的设备。如果成功，此函数返回零；如果出现错误情况，则返回负的错误代码。