Freigeben über


GattCharacteristic Klasse

Definition

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)]
class GattCharacteristic final
/// [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)]
public sealed class GattCharacteristic
[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

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.

Gilt für: