BTH_LE_GATT_DESCRIPTOR_VALUE 结构 (bthledef.h)

BTH_LE_GATT_DESCRIPTOR_VALUE结构描述父特征。

语法

typedef struct _BTH_LE_GATT_DESCRIPTOR_VALUE {
  BTH_LE_GATT_DESCRIPTOR_TYPE DescriptorType;
  BTH_LE_UUID                 DescriptorUuid;
  union {
    struct {
      BOOLEAN IsReliableWriteEnabled;
      BOOLEAN IsAuxiliariesWritable;
    } CharacteristicExtendedProperties;
    struct {
      BOOLEAN IsSubscribeToNotification;
      BOOLEAN IsSubscribeToIndication;
    } ClientCharacteristicConfiguration;
    struct {
      BOOLEAN IsBroadcast;
    } ServerCharacteristicConfiguration;
    struct {
      UCHAR       Format;
      UCHAR       Exponent;
      BTH_LE_UUID Unit;
      UCHAR       NameSpace;
      BTH_LE_UUID Description;
    } CharacteristicFormat;
  };
  ULONG                       DataSize;
#if ...
  UCHAR                       *Data[];
#else
  UCHAR                       Data[1];
#endif
} BTH_LE_GATT_DESCRIPTOR_VALUE, *PBTH_LE_GATT_DESCRIPTOR_VALUE;

成员

DescriptorType

描述符值的类型。

DescriptorUuid

通用唯一 ID (描述符值的 UUID) 。

CharacteristicExtendedProperties

不同特征扩展属性成员的容器结构。

CharacteristicExtendedProperties.IsReliableWriteEnabled

父特征值已启用可靠写入。

CharacteristicExtendedProperties.IsAuxiliariesWritable

特征用户描述符是可写的。

ClientCharacteristicConfiguration

不同客户端特征配置成员的容器结构。

ClientCharacteristicConfiguration.IsSubscribeToNotification

是否已向设备注册特征以接收句柄值通知。 如果特征已注册,则为 TRUE。 否则为 FALSE。

ClientCharacteristicConfiguration.IsSubscribeToIndication

是否已向设备注册特征以接收句柄值指示。 如果特征已注册,则为 TRUE。 否则为 FALSE。

ServerCharacteristicConfiguration

不同服务器特征配置成员的容器结构。

ServerCharacteristicConfiguration.IsBroadcast

可以广播父特征值。

CharacteristicFormat

不同特征格式成员的容器结构。

CharacteristicFormat.Format

父特征值的格式。

CharacteristicFormat.Exponent

用于确定特征值值进一步设置格式的方式的指数值。

CharacteristicFormat.Unit

指定数字规范中定义的特征值的单位。

CharacteristicFormat.NameSpace

在“分配号码”规范中定义单位的名称空间。

CharacteristicFormat.Description

通用唯一 ID (UUID) ,用于描述父特征值的格式。

DataSize

描述符值的大小(以字节为单位)。

Data[*]

指向描述符值数据的指针。

Data[1]

指向描述符值数据的指针。

要求

要求
最低受支持的客户端 版本:Windows 8 中的_Supported
标头 bthledef.h (包括 BthLEDef.h)

另请参阅

BTH_LE_GATT_DESCRIPTOR_TYPE

BTH_LE_UUID

BluetoothGATTGetDescriptorValue

BluetoothGATTSetDescriptorValue