GattCharacteristic Klasse

Definition

Namespace:

Windows.Devices.Bluetooth.GenericAttributeProfile

Stellt ein Merkmal eines GATT-Diensts dar. Das GattCharacteristic-Objekt stellt ein GATT-Merkmal eines bestimmten Diensts dar und wird von der Characteristics-Eigenschaft des GattDeviceService-Objekts abgerufen.

public ref class GattCharacteristic sealed

/// [Windows.Foundation.Metadata.ContractVersion(Windows.Foundation.UniversalApiContract, 65536)]
/// [Windows.Foundation.Metadata.MarshalingBehavior(Windows.Foundation.Metadata.MarshalingType.Agile)]
/// [Windows.Foundation.Metadata.Threading(Windows.Foundation.Metadata.ThreadingModel.Both)]
class GattCharacteristic final

[Windows.Foundation.Metadata.ContractVersion(typeof(Windows.Foundation.UniversalApiContract), 65536)]
[Windows.Foundation.Metadata.MarshalingBehavior(Windows.Foundation.Metadata.MarshalingType.Agile)]
[Windows.Foundation.Metadata.Threading(Windows.Foundation.Metadata.ThreadingModel.Both)]
public sealed class GattCharacteristic

Public NotInheritable Class GattCharacteristic

Vererbung

Object Platform::Object IInspectable GattCharacteristic

Attribute

ContractVersionAttribute MarshalingBehaviorAttribute ThreadingAttribute

Windows-Anforderungen

Gerätefamilie	Windows 10 (eingeführt in 10.0.10240.0 - for Xbox, see UWP features that aren't yet supported on Xbox)
API contract	Windows.Foundation.UniversalApiContract (eingeführt in v1.0)
App-Funktionen	bluetooth

Hinweise

Versionsverlauf

Windows-Version	SDK-Version	Wertschöpfung
1703	15063	GetDescriptorsAsync
1703	15063	GetDescriptorsAsync(BluetoothCacheMode)
1703	15063	GetDescriptorsForUuidAsync(Guid)
1703	15063	GetDescriptorsForUuidAsync(Guid,BluetoothCacheMode)
1703	15063	WriteClientCharacteristicConfigurationDescriptorWithResultAsync
1703	15063	WriteValueWithResultAsync(IBuffer)
1703	15063	WriteValueWithResultAsync(IBuffer,GattWriteOption)

Eigenschaften

AttributeHandle	Ruft das Handle ab, das verwendet wird, um GATT-basierte Merkmalsattribute eindeutig zu identifizieren, die auf dem Bluetooth LE-Gerät deklariert sind.
CharacteristicProperties	Ruft die GATT-Merkmalseigenschaften ab, die durch das GATT-Profil definiert sind. Wenn das ExtendedProperties-Flag vorhanden ist, stellt es auch die Eigenschaften des Deskriptors für erweiterte Eigenschaften dar.
PresentationFormats	Ruft die Liste der Diesem GattCharacteristic zugeordneten Präsentationsformatdeskriptoren in der vom Aggregatformatdeskriptor angegebenen Reihenfolge ab. Die Liste muss leer sein, wenn keine PresentationFormat- oder Aggregate Format-Deskriptoren gefunden werden.
ProtectionLevel	Ruft die gewünschten GATT-Sicherheitsoptionen für die Over-the-Air-Kommunikation mit dem Gerät ab oder legt diese fest. Windows verhandelt die maximale Sicherheit mit dem Gerät im Rahmen des Kopplungsprozesses, und die Angabe eines niedrigeren Sicherheitsniveaus beeinträchtigt die vorhandene Sicherheitsstufe nicht.
Service	Ruft den GattDeviceService ab, dessen Element dieses Merkmal ist.
UserDescription	Rufen Sie die benutzerfreundliche Beschreibung für diese GattCharacteristic ab, wenn der Benutzerbeschreibungsdeskriptor vorhanden ist, andernfalls handelt es sich um eine leere Zeichenfolge.
Uuid	Ruft die GATT-Merkmals-UUID für diese GattCharacteristic ab.

Methoden

ConvertShortIdToUuid(UInt16)	Konvertiert eine von der Bluetooth SIG definierte kurze ID in eine vollständige GATT-UUID. Wichtig Die ConvertShortIdToUuid-API ist veraltet und in zukünftigen Versionen von Windows möglicherweise nicht verfügbar. Verwenden Sie stattdessen BluetoothUuidHelper.FromShortId.
GetAllDescriptors()	Ruft die Auflistung aller Deskriptoren ab, die zu diesem GattCharacteristic-instance gehören. Wichtig Die GetAllDescriptors-API ist veraltet und in zukünftigen Windows-Versionen möglicherweise nicht verfügbar. Verwenden Sie stattdessen GetDescriptorsAsync.
GetDescriptors(Guid)	Gibt einen Vektor von Deskriptoren zurück, die durch die angegebene UUID identifiziert werden und zu diesem GattCharacteristic instance gehören. Wichtig Die GetDescriptors-API ist veraltet und in zukünftigen Windows-Versionen möglicherweise nicht verfügbar. Verwenden Sie stattdessen GetDescriptorsForUuidAsync.
GetDescriptorsAsync()	Gibt die Deskriptoren für diese GattCharacteristic instance zurück.
GetDescriptorsAsync(BluetoothCacheMode)	Gibt die Deskriptoren mit dem angegebenen Cachemodus für diese GattCharacteristic-instance zurück.
GetDescriptorsForUuidAsync(Guid)	Gibt die Deskriptoren zurück, deren UUIDs mit descriptorUuid übereinstimmen.
GetDescriptorsForUuidAsync(Guid, BluetoothCacheMode)	Gibt die Deskriptoren zurück, deren UUIDs descriptorUuid mit dem angegebenen cacheMode übereinstimmen.
ReadClientCharacteristicConfigurationDescriptorAsync()	Liest den aktuellen Wert des ClientCharacteristicConfigurationDescriptor.
ReadValueAsync()	Führt einen Merkmalswertlesevorgang aus dem von Windows verwalteten Wertcache aus.
ReadValueAsync(BluetoothCacheMode)	Führt einen Merkmalswert aus, der entweder aus dem von Windows verwalteten Wertcache oder direkt vom Gerät gelesen wird.
WriteClientCharacteristicConfigurationDescriptorAsync(GattClientCharacteristicConfigurationDescriptorValue)	Schreibt clientCharacteristicConfigurationDescriptor in das Bluetooth LE-Gerät, und wenn der zu schreibende Wert einen Hinweis oder eine Benachrichtigung darstellt und ein ValueChanged-Ereignishandler registriert ist, wird der Empfang von ValueChanged-Ereignissen vom Gerät aktiviert.
WriteClientCharacteristicConfigurationDescriptorWithResultAsync(GattClientCharacteristicConfigurationDescriptorValue)	Schreibt clientCharacteristicConfigurationDescriptor in das Bluetooth LE-Gerät, und wenn der zu schreibende Wert einen Hinweis oder eine Benachrichtigung darstellt und ein ValueChanged-Ereignishandler registriert ist, wird der Empfang von ValueChanged-Ereignissen vom Gerät aktiviert.
WriteValueAsync(IBuffer)	Führt einen Merkmalswertschreibvorgang auf ein Bluetooth LE-Gerät aus.
WriteValueAsync(IBuffer, GattWriteOption)	Führt einen Merkmalswertschreibvorgang auf ein Bluetooth LE-Gerät aus.
WriteValueWithResultAsync(IBuffer)	Führt einen Merkmalswertschreibvorgang auf ein Bluetooth LE-Gerät aus.
WriteValueWithResultAsync(IBuffer, GattWriteOption)	Führt einen Merkmalswertschreibvorgang auf ein Bluetooth LE-Gerät aus.

Ereignisse

ValueChanged

Eine App kann einen Ereignishandler registrieren, um Ereignisse zu empfangen, wenn Benachrichtigungen oder Hinweise von einem Gerät empfangen werden, nachdem sie die Client merkmalskonfigurationsdeskriptor festgelegt hat.