Adding support for Low Energy device discovery to BluetoothAdapterMac

device/bluetooth/bluetooth_adapter.h

 // Copyright (c) 2012 The Chromium Authors. All rights reserved.
 // Use of this source code is governed by a BSD-style license that can be
 // found in the LICENSE file.
 
 #ifndef DEVICE_BLUETOOTH_BLUETOOTH_ADAPTER_H_
 #define DEVICE_BLUETOOTH_BLUETOOTH_ADAPTER_H_
 
 #include <list>
 #include <map>
 #include <set>
@@ skipping 404 matching lines @@
   //    - If there is a pending request to the subsystem, queue this request to
   //      execute once the pending requests are done.
   //    - If the count is 0, return failure, as there is no active discovery
   //      session.
   //    - If the count is 1, issue a request to the subsystem to stop device
   //      discovery and decrement the count to 0 on success.
   //    - If the count is greater than 1, decrement the count and return
   //      success.
   //
   // |discovery_filter| passed to AddDiscoverySession and RemoveDiscoverySession
-  // is owned by other objects and shall not be freed.
+  // is owned by other objects and shall not be freed.  When the count is
+  // greater than 0 and AddDiscoverySession or RemoveDiscoverySession is called
+  // the filter being used by the underlying controller must be updated.
   //
   // These methods invoke |callback| for success and |error_callback| for
   // failures.
   virtual void AddDiscoverySession(BluetoothDiscoveryFilter* discovery_filter,
                                    const base::Closure& callback,
                                    const ErrorCallback& error_callback) = 0;
   virtual void RemoveDiscoverySession(
       BluetoothDiscoveryFilter* discovery_filter,
       const base::Closure& callback,
       const ErrorCallback& error_callback) = 0;
+
+  // Used to set and update the discovery filter used by the underlying
+  // Bluetooth controller.
   virtual void SetDiscoveryFilter(
       scoped_ptr<BluetoothDiscoveryFilter> discovery_filter,
       const base::Closure& callback,
       const ErrorCallback& error_callback) = 0;
 
   // Called by RemovePairingDelegate() in order to perform any class-specific
   // internal functionality necessary to remove the pairing delegate, such as
   // cleaning up ongoing pairings using it.
   virtual void RemovePairingDelegateInternal(
       BluetoothDevice::PairingDelegate* pairing_delegate) = 0;
@@ skipping 42 matching lines @@
   std::set<BluetoothDiscoverySession*> discovery_sessions_;
 
   // Note: This should remain the last member so it'll be destroyed and
   // invalidate its weak pointers before any other members are destroyed.
   base::WeakPtrFactory<BluetoothAdapter> weak_ptr_factory_;
 };
 
 }  // namespace device
 
 #endif  // DEVICE_BLUETOOTH_BLUETOOTH_ADAPTER_H_