estructura BTH_LE_GATT_DESCRIPTOR_VALUE (bthledef.h)

Artículo
08/22/2023

La estructura BTH_LE_GATT_DESCRIPTOR_VALUE describe una característica primaria.

Sintaxis

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;

Miembros

DescriptorType

Tipo del valor del descriptor.

DescriptorUuid

Identificador único universal (UUID) del valor del descriptor.

CharacteristicExtendedProperties

Estructura de contenedor para los distintos miembros de propiedad extendida característica.

CharacteristicExtendedProperties.IsReliableWriteEnabled

El valor de característica principal está habilitado para escritura confiable.

CharacteristicExtendedProperties.IsAuxiliariesWritable

El descriptor de descripción del usuario característico se puede escribir.

ClientCharacteristicConfiguration

Estructura de contenedor para los distintos miembros de configuración de características de cliente.

ClientCharacteristicConfiguration.IsSubscribeToNotification

Si la característica se ha registrado con el dispositivo para recibir notificaciones de identificador de valor. TRUE si se ha registrado la característica. De lo contrario, FALSE.

ClientCharacteristicConfiguration.IsSubscribeToIndication

Si la característica se ha registrado con el dispositivo para recibir indicaciones de valor de identificador. TRUE si se ha registrado la característica. De lo contrario, FALSE.

ServerCharacteristicConfiguration

Estructura de contenedor para los distintos miembros de configuración de características del servidor.

ServerCharacteristicConfiguration.IsBroadcast

El valor de característica primario se puede difundir.

CharacteristicFormat

Estructura de contenedor para los distintos miembros de formato de características.

CharacteristicFormat.Format

Formato del valor de característica primario.

CharacteristicFormat.Exponent

Valor exponente que se va a usar para determinar cómo se da formato al valor de la característica.

CharacteristicFormat.Unit

Unidad del valor de característica tal y como se define en la especificación Números asignados.

CharacteristicFormat.NameSpace

Espacio de nombres donde se define la unidad en la especificación Números asignados.

CharacteristicFormat.Description

Identificador único universal (UUID) que describe el formato del valor de característica primario.

DataSize

Tamaño, en bytes, del valor del descriptor.

Data[*]

Puntero a los datos del valor del descriptor.

Data[1]

Puntero a los datos del valor del descriptor.

Requisitos

Requisito	Value
Cliente mínimo compatible	Versiones:_Supported en Windows 8
Encabezado	bthledef.h (incluya BthLEDef.h)

Consulte también

BTH_LE_GATT_DESCRIPTOR_TYPE

BTH_LE_UUID

BluetoothGATTGetDescriptorValue

BluetoothGATTSetDescriptorValue

Share via