BluetoothGATTGetIncludedServices 函数是 Win32 API 中用于获取蓝牙 GATT 特征的包含服务的函数,声明在 Bluetoothleapis.h 头文件中。这个函数的主要目的是检索给定 GATT 特征包含的服务。

以下是该函数的声明:
HRESULT BluetoothGATTGetIncludedServices(
  HANDLE                       hDevice,
  PBTH_LE_GATT_CHARACTERISTIC pCharacteristic,
  ULONG                        ServiceBufferCount,
  PBTH_LE_GATT_SERVICE         pServiceBuffer,
  ULONG                        *pServicesBufferCount
);

函数参数的含义如下:

  •  hDevice: 表示 GATT 设备的句柄。

  •  pCharacteristic: 指向 BTH_LE_GATT_CHARACTERISTIC 结构的指针,其中包含 GATT 特征的信息。

  •  ServiceBufferCount: 表示 pServiceBuffer 缓冲区数组的大小。

  •  pServiceBuffer: 指向用于存储服务信息的缓冲区数组。

  •  pServicesBufferCount: 返回实际写入缓冲区的服务数量。


函数的返回值为 HRESULT 类型,表示操作的结果。如果函数成功执行,将返回 S_OK。

在使用该函数之前,您需要确保已经建立了与目标设备的 GATT 连接,并且已经获取了设备的句柄。同时,您还需要了解 GATT 特征的相关信息,以便正确填充 pCharacteristic 结构。函数将返回与特征相关联的服务信息,这些服务信息将存储在 pServiceBuffer 数组中,由 pServicesBufferCount 返回实际写入的服务数量。


转载请注明出处:http://www.zyzy.cn/article/detail/24095/Win32 API/Bluetoothleapis.h/BluetoothGATTGetIncludedServices