GattDeviceService Klasse

Definition

Namespace:

Windows.Devices.Bluetooth.GenericAttributeProfile

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)]
/// [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)]
[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

ContractVersionAttribute MarshalingBehaviorAttribute ThreadingAttribute

Implementiert

IClosable IDisposable

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.

Weitere Informationen

• BluetoothLEDevice
• IClosable