BLE GATT service implementation in Chrome for Windows 8 and later

device/bluetooth/bluetooth_low_energy_win.h

 // Copyright 2014 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_LOW_ENERGY_WIN_H_
 #define DEVICE_BLUETOOTH_BLUETOOTH_LOW_ENERGY_WIN_H_
 
 #include <stddef.h>
 #include <stdint.h>
 
 #include "base/files/file_path.h"
 #include "base/macros.h"
 #include "base/memory/scoped_ptr.h"
 #include "base/memory/scoped_vector.h"
 #include "base/win/scoped_handle.h"
 #include "device/bluetooth/bluetooth_export.h"
 #include "device/bluetooth/bluetooth_low_energy_defs_win.h"
 
 namespace device {
 namespace win {
 
 // Represents a device registry property value
 class DEVICE_BLUETOOTH_EXPORT DeviceRegistryPropertyValue {
  public:
   // Creates a property value instance, where |property_type| is one of REG_xxx
   // registry value type (e.g. REG_SZ, REG_DWORD), |value| is a byte array
   // containing the property value and |value_size| is the number of bytes in
   // |value|. Note the returned instance takes ownership of the bytes in
   // |value|.
-  static scoped_ptr<DeviceRegistryPropertyValue> Create(
-      DWORD property_type,
-      scoped_ptr<uint8_t[]> value,
-      size_t value_size);
+  static scoped_ptr<DeviceRegistryPropertyValue>
+  Create(DWORD property_type, scoped_ptr<uint8_t[]> value, size_t value_size);
   ~DeviceRegistryPropertyValue();
 
   // Returns the vaue type a REG_xxx value (e.g. REG_SZ, REG_DWORD, ...)
   DWORD property_type() const { return property_type_; }
 
   std::string AsString() const;
   DWORD AsDWORD() const;
 
  private:
   DeviceRegistryPropertyValue(DWORD property_type,
@@ skipping 32 matching lines @@
 };
 
 // Returns true only on Windows platforms supporting Bluetooth Low Energy.
 bool IsBluetoothLowEnergySupported();
 
 struct BluetoothLowEnergyServiceInfo {
   BluetoothLowEnergyServiceInfo();
   ~BluetoothLowEnergyServiceInfo();
 
   BTH_LE_UUID uuid;
+  USHORT attribute_handle;
+  base::FilePath path;
 };
 
 struct BluetoothLowEnergyDeviceInfo {
   BluetoothLowEnergyDeviceInfo();
   ~BluetoothLowEnergyDeviceInfo();
 
   base::FilePath path;
   std::string id;
   std::string friendly_name;
   BLUETOOTH_ADDRESS address;
   bool visible;
   bool authenticated;
   bool connected;
 };
 
 // Enumerates the list of known (i.e. already paired) Bluetooth LE devices on
 // this machine. In case of error, returns false and sets |error| with an error
 // message describing the problem.
 // Note: This function returns an error if Bluetooth Low Energy is not supported
 // on this Windows platform.
 bool EnumerateKnownBluetoothLowEnergyDevices(
+    GUID guid,
     ScopedVector<BluetoothLowEnergyDeviceInfo>* devices,
     std::string* error);
 
 // Enumerates the list of known (i.e. cached) GATT services for a given
 // Bluetooth LE device |device_path| into |services|. In case of error, returns
 // false and sets |error| with an error message describing the problem. Note:
 // This function returns an error if Bluetooth Low Energy is not supported on
 // this Windows platform.
 bool EnumerateKnownBluetoothLowEnergyServices(
     const base::FilePath& device_path,
     ScopedVector<BluetoothLowEnergyServiceInfo>* services,
     std::string* error);
 
 bool DEVICE_BLUETOOTH_EXPORT
 ExtractBluetoothAddressFromDeviceInstanceIdForTesting(
     const std::string& instance_id,
     BLUETOOTH_ADDRESS* btha,
     std::string* error);
 
+HRESULT ReadPrimaryServicesOfADevice(HANDLE device_handle,
+                                     BTH_LE_GATT_SERVICE** out_primary_services,
+                                     USHORT* out_counts);
+
+HRESULT ReadCharacteristicsOfAService(
+    HANDLE device_handle,
+    const PBTH_LE_GATT_SERVICE service_uuid,
+    BTH_LE_GATT_CHARACTERISTIC** out_included_characteristics,
+    USHORT* out_counts);
+
+HRESULT ReadIncludedServicesOfAService(
+    HANDLE device_handle,
+    const PBTH_LE_GATT_SERVICE service_uuid,
+    BTH_LE_GATT_SERVICE** out_included_services,
+    USHORT* out_counts);
+
+HRESULT ReadTheValueOfACharacteristic(
+    HANDLE device_handle,
+    const PBTH_LE_GATT_CHARACTERISTIC characteristic,
+    BTH_LE_GATT_CHARACTERISTIC_VALUE** out_characteristic_value);
+
+HRESULT WriteTheValueOfACharacteristic(
+    HANDLE device_handle,
+    const PBTH_LE_GATT_CHARACTERISTIC characteristic,
+    BTH_LE_GATT_CHARACTERISTIC_VALUE* new_value);
+
+HRESULT ReliableWriteTheValueOfACharacteristic(
+    HANDLE device_handle,
+    const PBTH_LE_GATT_CHARACTERISTIC characteristic,
+    BTH_LE_GATT_CHARACTERISTIC_VALUE* new_value);
+
+HRESULT ReadDescriptorsOfACharacteristic(
+    HANDLE device_handle,
+    const PBTH_LE_GATT_CHARACTERISTIC characteristic,
+    BTH_LE_GATT_DESCRIPTOR** out_included_descriptors,
+    USHORT* out_counts);
+
+HRESULT ReadTheValueOfADescriptor(HANDLE device_handle,
+                                  const PBTH_LE_GATT_DESCRIPTOR descriptor,
+                                  BTH_LE_GATT_DESCRIPTOR_VALUE** out_value);
+
+HRESULT WriteTheDescriptorValue(HANDLE device_handle,
+                                const PBTH_LE_GATT_DESCRIPTOR descriptor,
+                                BTH_LE_GATT_DESCRIPTOR_VALUE* new_value);
+
+HRESULT RegisterGattEvents(HANDLE device_handle,
+                           BTH_LE_GATT_EVENT_TYPE type,
+                           PVOID event_parameter,
+                           PFNBLUETOOTH_GATT_EVENT_CALLBACK callback,
+                           PVOID context,
+                           BLUETOOTH_GATT_EVENT_HANDLE* out_handle);
+
+HRESULT UnregisterGattEvent(BLUETOOTH_GATT_EVENT_HANDLE event_handle);
+
 }  // namespace win
 }  // namespace device
 
 #endif  // DEVICE_BLUETOOTH_BLUETOOTH_LOW_ENERGY_WIN_H_