Freigeben über


GattDeviceService Klasse

Definition

Stellt einen primären GATT-Dienst auf einem Bluetooth-Gerät dar. Die GattDeviceService-Klasse stellt einen GATT-Dienst auf einem Bluetooth LE-Gerät dar. Die Instanziierung erfolgt mithilfe eines Gerätediensts instance Pfads, der durch Suchen eines Geräts mithilfe der Windows.Devices.Enumeration-API abgerufen wird.

public ref class GattDeviceService sealed : IClosable
/// [Windows.Foundation.Metadata.ContractVersion(Windows.Foundation.UniversalApiContract, 65536)]
/// [Windows.Foundation.Metadata.MarshalingBehavior(Windows.Foundation.Metadata.MarshalingType.Agile)]
class GattDeviceService final : IClosable
/// [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 GattDeviceService final : IClosable
[Windows.Foundation.Metadata.ContractVersion(typeof(Windows.Foundation.UniversalApiContract), 65536)]
[Windows.Foundation.Metadata.MarshalingBehavior(Windows.Foundation.Metadata.MarshalingType.Agile)]
public sealed class GattDeviceService : System.IDisposable
[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 GattDeviceService : System.IDisposable
Public NotInheritable Class GattDeviceService
Implements IDisposable
Vererbung
Object Platform::Object IInspectable GattDeviceService
Attribute
Implementiert

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 Mehrwert
1703 15063 DeviceAccessInformation
1703 15063 FromIdAsync(String,GattSharingMode)
1703 15063 GetCharacteristicsAsync
1703 15063 GetCharacteristicsAsync(BluetoothCacheMode)
1703 15063 GetCharacteristicsForUuidAsync(Guid)
1703 15063 GetCharacteristicsForUuidAsync(Guid,BluetoothCacheMode)
1703 15063 GetDeviceSelectorForBluetoothDeviceId(BluetoothDeviceId)
1703 15063 GetDeviceSelectorForBluetoothDeviceId(BluetoothDeviceId,BluetoothCacheMode)
1703 15063 GetDeviceSelectorForBluetoothDeviceIdAndUuid(BluetoothDeviceId,Guid)
1703 15063 GetDeviceSelectorForBluetoothDeviceIdAndUuid(BluetoothDeviceId,Guid,BluetoothCacheMode)
1703 15063 GetIncludedServicesAsync
1703 15063 GetIncludedServicesAsync(BluetoothCacheMode)
1703 15063 GetIncludedServicesForUuidAsync(Guid)
1703 15063 GetIncludedServicesForUuidAsync(Guid,BluetoothCacheMode)
1703 15063 OpenAsync
1703 15063 RequestAccessAsync
1703 15063 Sitzung
1703 15063 SharingMode

Eigenschaften

AttributeHandle

Ruft das Handle ab, mit dem GATT-basierte Dienstattribute eindeutig identifiziert werden, wie auf dem Bluetooth LE-Gerät deklariert.

Device

Ruft das BluetoothLEDevice-Objekt ab , das das Dem aktuellen GattDeviceService-Objekt zugeordnete Gerät beschreibt.

Wichtig

Die Geräte-API ist veraltet und in zukünftigen Versionen von Windows möglicherweise nicht verfügbar. Verwenden Sie stattdessen Session.

DeviceAccessInformation

Ruft die Gerätezugriffsinformationen ab, die dem aktuellen GattDeviceService-Objekt zugeordnet sind.

DeviceId

Rufen Sie die Zeichenfolge ab, die den GATT-Dienst instance Pfad darstellt, der zum Instanziieren des GattDeviceService verwendet wird.

ParentServices

Ruft die schreibgeschützte Liste der übergeordneten Dienste für diesen Dienst ab.

Wichtig

Die ParentServices-API ist veraltet und in zukünftigen Versionen von Windows möglicherweise nicht verfügbar.

Session

Ruft die Sitzung für diesen GATT-Gerätedienst instance ab.

SharingMode

Ruft den Freigabemodus für diesen GATT-Gerätedienst instance ab.

Uuid

Ruft die GATT-Dienst-UUID ab, die diesem GattDeviceService zugeordnet ist.

Methoden

Close()

Gibt die Ressourcen frei, die der GattDeviceService-Klasse zugeordnet sind. Dadurch können andere Apps auf die Ressourcen des betreffenden GattDeviceService zugreifen. Verwenden Sie kein GattDeviceService-Objekt , nachdem Sie "Close " aufgerufen haben. Instanziieren Sie stattdessen ein neues GattDeviceService-Objekt mithilfe der FromIdAsync-Methode .

Rufen Sie für C++ Schließen auf. Für .NET-Sprachen wird diese Close-Methode in Dispose projiziert.

ConvertShortIdToUuid(UInt16)

Konvertiert eine von Bluetooth SIG definierte Kurz-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.

Dispose()

Führt anwendungsspezifische Aufgaben durch, die mit der Freigabe, der Zurückgabe oder dem Zurücksetzen von nicht verwalteten Ressourcen zusammenhängen.

FromIdAsync(String)

Instanziiert einen neuen GattDeviceService aus der Geräte-ID.

FromIdAsync(String, GattSharingMode)

Instanziiert ein neues GattDeviceService-Objekt aus der Geräte-ID.

GetAllCharacteristics()

Ruft die Auflistung aller Merkmale ab, die zu diesem GattDeviceService-instance gehören.

Wichtig

Die GetAllCharacteristics-API ist veraltet und in zukünftigen Versionen von Windows möglicherweise nicht verfügbar. Verwenden Sie stattdessen GetCharacteristicsAsync.

GetAllIncludedServices()

Ruft die Auflistung aller enthaltenen Dienste ab, die zu diesem GattDeviceService-instance gehören.

Wichtig

Die GetAllCharacteristics-API ist veraltet und in zukünftigen Versionen von Windows möglicherweise nicht verfügbar. Verwenden Sie stattdessen GetIncludedServicesAsync.

GetCharacteristics(Guid)

Gibt einen Vektor von Merkmalen zurück, die durch die angegebene UUID identifiziert werden und zu diesem GattDeviceService-instance gehören.

Wichtig

Die GetCharacteristics-API ist veraltet und in zukünftigen Versionen von Windows möglicherweise nicht verfügbar. Verwenden Sie stattdessen GetCharacteristicsForUuidAsync.

GetCharacteristicsAsync()

Ruft die Merkmale ab, die Teil dieses GattDeviceService-instance sind.

GetCharacteristicsAsync(BluetoothCacheMode)

Ruft die Merkmale ab, die Teil dieses GattDeviceService-instance sind.

GetCharacteristicsForUuidAsync(Guid)

Ruft die Characterisitics ab, die Teil dieses GattDeviceService-instance und dem MerkmalUuid zugeordnet sind.

GetCharacteristicsForUuidAsync(Guid, BluetoothCacheMode)

Ruft die Characterisitics ab, die Teil dieses GattDeviceService-instance und dem MerkmalUuid zugeordnet sind.

GetDeviceSelectorForBluetoothDeviceId(BluetoothDeviceId)

Erstellt eine geeignete AQS-Filterzeichenfolge für die Verwendung mit der CreateWatcher-Methode aus einer BluetoothDeviceId.

GetDeviceSelectorForBluetoothDeviceId(BluetoothDeviceId, BluetoothCacheMode)

Erstellt eine geeignete AQS-Filterzeichenfolge für die Verwendung mit der CreateWatcher-Methode aus einer BluetoothDeviceId.

GetDeviceSelectorForBluetoothDeviceIdAndUuid(BluetoothDeviceId, Guid)

Erstellt eine geeignete AQS-Filterzeichenfolge für die Verwendung mit der CreateWatcher-Methode aus einer BluetoothDeviceId und serviceUuid.

GetDeviceSelectorForBluetoothDeviceIdAndUuid(BluetoothDeviceId, Guid, BluetoothCacheMode)

Erstellt eine geeignete AQS-Filterzeichenfolge für die Verwendung mit der CreateWatcher-Methode aus einer BluetoothDeviceId und serviceUuid.

GetDeviceSelectorFromShortId(UInt16)

Erstellt eine geeignete AQS-Filterzeichenfolge für die Verwendung mit der CreateWatcher-Methode aus einer 16-Bit-Bluetooth GATT-Dienst-UUID.

Wichtig

Die GetDeviceSelectorFromShortId-API ist veraltet und in zukünftigen Versionen von Windows möglicherweise nicht verfügbar. Verwenden Sie stattdessen GetDeviceSelectorFromUuid.

GetDeviceSelectorFromUuid(Guid)

Erstellt eine geeignete AQS-Filterzeichenfolge für die Verwendung mit der CreateWatcher-Methode aus einer Bluetooth-Dienst-UUID.

GetIncludedServices(Guid)

Gibt einen Vektor von eingeschlossenen Diensten zurück, die durch die angegebene UUID identifiziert werden und zu diesem GattDeviceService-instance gehören.

Wichtig

Die GetIncludedServices-API ist veraltet und in zukünftigen Versionen von Windows möglicherweise nicht verfügbar. Verwenden Sie stattdessen GetIncludedServicesForUuidAsync.

GetIncludedServicesAsync()

Ruft die enthaltenen Dienste ab, die diesem GattDeviceService-instance zugeordnet sind.

GetIncludedServicesAsync(BluetoothCacheMode)

Ruft die enthaltenen Dienste ab, die diesem GattDeviceService-instance zugeordnet sind.

GetIncludedServicesForUuidAsync(Guid)

Ruft die enthaltenen Dienste aus dem serviceUuid ab, der diesem GattDeviceService-instance zugeordnet ist.

GetIncludedServicesForUuidAsync(Guid, BluetoothCacheMode)

Ruft die enthaltenen Dienste aus dem serviceUuid ab, der diesem GattDeviceService-instance zugeordnet ist.

OpenAsync(GattSharingMode)

Öffnet den GATT-Gerätedienst mit dem angegebenen sharingMode.

RequestAccessAsync()

Fordert Zugriff auf gattDeviceService an.

Gilt für:

Weitere Informationen