GattDeviceService Classe

Définition

Espace de noms:

Windows.Devices.Bluetooth.GenericAttributeProfile

Représente un service principal GATT sur un appareil Bluetooth. La classe GattDeviceService représente un service GATT sur un appareil Bluetooth LE. Il est instancié à l’aide d’un chemin d’accès instance service d’appareil, obtenu en recherchant un appareil à l’aide de l’API Windows.Devices.Enumeration.

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

Héritage

Object Platform::Object IInspectable GattDeviceService

Attributs

ContractVersionAttribute MarshalingBehaviorAttribute ThreadingAttribute

Implémente

IClosable IDisposable

Configuration requise pour Windows

Famille d’appareils	Windows 10 (introduit dans 10.0.10240.0 - for Xbox, see UWP features that aren't yet supported on Xbox)
API contract	Windows.Foundation.UniversalApiContract (introduit dans v1.0)
Fonctionnalités de l’application	bluetooth

Remarques

Historique des versions

Version de Windows	Version du SDK	Valeur ajoutée
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	session
1703	15063	SharingMode

Propriétés

AttributeHandle	Obtient le handle utilisé pour identifier de manière unique les attributs de service basés sur le GATT comme déclarés sur l’appareil Bluetooth LE.
Device	Obtient l’objet BluetoothLEDevice décrivant l’appareil associé à l’objet GattDeviceService actuel. Important L’API d’appareil est déconseillée et peut ne pas être disponible dans les versions futures de Windows. Utilisez plutôt Session.
DeviceAccessInformation	Obtient les informations d’accès à l’appareil associées à l’objet GattDeviceService actuel.
DeviceId	Obtenez la chaîne qui représente le service GATT instance chemin utilisé pour instancier le Service GattDeviceService.
ParentServices	Obtient la liste en lecture seule des services parents pour ce service. Important L’API ParentServices est déconseillée et peut ne pas être disponible dans les versions futures de Windows.
Session	Obtient la session de ce service d’appareil GATT instance.
SharingMode	Obtient le mode de partage pour ce service d’appareil GATT instance.
Uuid	Obtient l’UUID du service GATT associé à ce Service GattDeviceService.

Méthodes

Close()	Libère les ressources associées à la classe GattDeviceService . Cela permet à d’autres applications d’accéder aux ressources de GattDeviceService en question. N’utilisez pas d’objet GattDeviceService après avoir appelé Close sur celui-ci ; instanciez plutôt un nouvel objet GattDeviceService à l’aide de la méthode FromIdAsync . Pour C++, appelez Close. Pour les langages .NET, cette méthode Close est projetée dans Disposer.
ConvertShortIdToUuid(UInt16)	Convertit un ID court défini par le SIG Bluetooth en un UUID GATT complet. Important L’API ConvertShortIdToUuid est déconseillée et peut ne pas être disponible dans les versions futures de Windows. Utilisez plutôt BluetoothUuidHelper.FromShortId.
Dispose()	Exécute les tâches définies par l'application associées à la libération ou à la redéfinition des ressources non managées.
FromIdAsync(String)	Instancie un nouveau GattDeviceService à partir de l’ID de l’appareil.
FromIdAsync(String, GattSharingMode)	Instancie un nouvel objet GattDeviceService à partir de l’ID d’appareil.
GetAllCharacteristics()	Obtient la collection de toutes les caractéristiques appartenant à ce instance GattDeviceService. Important L’API GetAllCharacteristics est déconseillée et peut ne pas être disponible dans les versions futures de Windows. Utilisez plutôt GetCharacteristicsAsync.
GetAllIncludedServices()	Obtient la collection de tous les services inclus appartenant à ce instance GattDeviceService. Important L’API GetAllCharacteristics est déconseillée et peut ne pas être disponible dans les versions futures de Windows. Utilisez plutôt GetIncludedServicesAsync.
GetCharacteristics(Guid)	Retourne un vecteur de caractéristiques, qui sont identifiées par l’UUID spécifié et qui appartiennent à ce instance GattDeviceService. Important L’API GetCharacteristics est déconseillée et peut ne pas être disponible dans les versions futures de Windows. Utilisez plutôt GetCharacteristicsForUuidAsync.
GetCharacteristicsAsync()	Obtient les caractéristiques qui font partie de cette instance GattDeviceService.
GetCharacteristicsAsync(BluetoothCacheMode)	Obtient les caractéristiques qui font partie de cette instance GattDeviceService.
GetCharacteristicsForUuidAsync(Guid)	Obtient les caractères qui font partie de cette instance GattDeviceService et qui sont associés à la caractéristiqueUuid.
GetCharacteristicsForUuidAsync(Guid, BluetoothCacheMode)	Obtient les caractères qui font partie de cette instance GattDeviceService et qui sont associés à la caractéristiqueUuid.
GetDeviceSelectorForBluetoothDeviceId(BluetoothDeviceId)	Crée une chaîne de filtre AQS appropriée à utiliser avec la méthode CreateWatcher , à partir d’un BluetoothDeviceId.
GetDeviceSelectorForBluetoothDeviceId(BluetoothDeviceId, BluetoothCacheMode)	Crée une chaîne de filtre AQS appropriée à utiliser avec la méthode CreateWatcher , à partir d’un BluetoothDeviceId.
GetDeviceSelectorForBluetoothDeviceIdAndUuid(BluetoothDeviceId, Guid)	Crée une chaîne de filtre AQS appropriée à utiliser avec la méthode CreateWatcher , à partir d’un BluetoothDeviceId et d’un serviceUuid.
GetDeviceSelectorForBluetoothDeviceIdAndUuid(BluetoothDeviceId, Guid, BluetoothCacheMode)	Crée une chaîne de filtre AQS appropriée à utiliser avec la méthode CreateWatcher , à partir d’un BluetoothDeviceId et d’un serviceUuid.
GetDeviceSelectorFromShortId(UInt16)	Crée une chaîne de filtre AQS appropriée à utiliser avec la méthode CreateWatcher , à partir d’un UUID de service BLUETOOTH GATT 16 bits. Important L’API GetDeviceSelectorFromShortId est déconseillée et peut ne pas être disponible dans les versions ultérieures de Windows. Utilisez plutôt GetDeviceSelectorFromUuid.
GetDeviceSelectorFromUuid(Guid)	Crée une chaîne de filtre AQS appropriée à utiliser avec la méthode CreateWatcher , à partir d’un UUID de service Bluetooth.
GetIncludedServices(Guid)	Retourne un vecteur de services inclus, qui sont identifiés par l’UUID spécifié et appartiennent à ce instance GattDeviceService. Important L’API GetIncludedServices est déconseillée et peut ne pas être disponible dans les versions futures de Windows. Utilisez plutôt GetIncludedServicesForUuidAsync.
GetIncludedServicesAsync()	Obtient les services inclus associés à ce instance GattDeviceService.
GetIncludedServicesAsync(BluetoothCacheMode)	Obtient les services inclus associés à ce instance GattDeviceService.
GetIncludedServicesForUuidAsync(Guid)	Obtient les services inclus à partir du serviceUuid associé à ce instance GattDeviceService.
GetIncludedServicesForUuidAsync(Guid, BluetoothCacheMode)	Obtient les services inclus à partir du serviceUuid associé à ce instance GattDeviceService.
OpenAsync(GattSharingMode)	Ouvre le service d’appareil GATT avec le sharingMode spécifié.
RequestAccessAsync()	Demande l’accès au Service GattDevice.

Voir aussi

• BluetoothLEDevice
• IClosable