GattDeviceService Classe
Définition
Important
Certaines informations portent sur la préversion du produit qui est susceptible d’être en grande partie modifiée avant sa publication. Microsoft exclut toute garantie, expresse ou implicite, concernant les informations fournies ici.
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
- 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. |