Partager via


GattDeviceService Classe

Définition

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)]
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
Héritage
Object Platform::Object IInspectable GattDeviceService
Attributs
Implémente

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.

S’applique à

Voir aussi