System.Bluetooth.TBluetoothLEAdapter.DoStartDiscovery

From RAD Studio API Documentation
Jump to: navigation, search

Delphi

function DoStartDiscovery(Timeout: Cardinal; const AFilterUUIDList: TBluetoothUUIDsList = nil;  const ABluetoothLEScanFilterList: TBluetoothLEScanFilterList = nil): Boolean; virtual; abstract;

C++

virtual bool __fastcall DoStartDiscovery(unsigned Timeout, TBluetoothUUIDsList* const AFilterUUIDList = (TBluetoothUUIDsList*)(0x0), TBluetoothLEScanFilterList* const ABluetoothLEScanFilterList = (TBluetoothLEScanFilterList*)(0x0)) = 0 ;

Properties

Type Visibility Source Unit Parent
function protected
System.Bluetooth.pas
System.Bluetooth.hpp
System.Bluetooth TBluetoothLEAdapter

Description

Note: This is an abstract method that platform-specific subclasses of TBluetoothLEAdapter implement.

Starts a discovery operation to find remote devices using Bluetooth Low Energy.

StartDiscovery calls DoStartDiscovery.

DoStartDiscovery accepts the following parameters:

  • Timeout: How much time you want to spend discovering remote devices using Bluetooth Low Energy.
  • AFilterUUIDList (Optional): A list of one or more Bluetooth UUIDs.
  • ABluetoothLEScanFilterList: A list of one or more BLE scan filters that allows to scan only for the specific BLE devices in the filters.

When the discovery operation finishes, your adapter calls DoDiscoveryEnd providing a list of discovered remote devices.

DoStartDiscovery returns True if the discovery starts successfully, or False if something prevents the discovery from starting.

Platform Support

Platform Notes

32-bit Windows
64-bit Windows

OS X

  • OnDiscoveryEnd always occurs some time after the specified Timeout, never before.
  • Always returns True.

iOS

  • OnDiscoveryEnd always occurs some time after the specified Timeout, never before.
  • Always returns True.

Android

  • OnDiscoveryEnd always occurs after the specified Timeout, never before.

See Also