BluetoothLEDevice.FromBluetoothAddressAsync Méthode

Définition

Espace de noms:

Windows.Devices.Bluetooth

Surcharges

FromBluetoothAddressAsync(UInt64)	Renvoie un objet BluetoothLEDevice représentant l’appareil Bluetooth LE homologue avec l’adresse donnée. Consultez Remarques (dans cette rubrique membre).
FromBluetoothAddressAsync(UInt64, BluetoothAddressType)	Renvoie un objet BluetoothLEDevice représentant l’appareil homologue avec l’adresse et le type d’adresse donnés. Consultez Remarques (dans cette rubrique membre).

FromBluetoothAddressAsync(UInt64)

Renvoie un objet BluetoothLEDevice représentant l’appareil Bluetooth LE homologue avec l’adresse donnée. Consultez Remarques (dans cette rubrique membre).

public:
 static IAsyncOperation<BluetoothLEDevice ^> ^ FromBluetoothAddressAsync(unsigned long long bluetoothAddress);

/// [Windows.Foundation.Metadata.RemoteAsync]
/// [Windows.Foundation.Metadata.Overload("FromBluetoothAddressAsync")]
 static IAsyncOperation<BluetoothLEDevice> FromBluetoothAddressAsync(uint64_t const& bluetoothAddress);

[Windows.Foundation.Metadata.RemoteAsync]
[Windows.Foundation.Metadata.Overload("FromBluetoothAddressAsync")]
public static IAsyncOperation<BluetoothLEDevice> FromBluetoothAddressAsync(ulong bluetoothAddress);

function fromBluetoothAddressAsync(bluetoothAddress)

Public Shared Function FromBluetoothAddressAsync (bluetoothAddress As ULong) As IAsyncOperation(Of BluetoothLEDevice)

Paramètres

bluetoothAddress

UInt64

unsigned long long

uint64_t

Valeur BluetoothAddress contenant l’adresse 64 bits de l’appareil Bluetooth LE homologue.

Retours

IAsyncOperation<BluetoothLEDevice>

Retourne un objet représentant une opération asynchrone. Une fois cet objet terminé, il contient un objet BluetoothLEDevice représentant l’appareil Bluetooth LE homologue avec l’adresse donnée.

Important

Le BluetoothLEDevice retourné est défini sur null si FromBluetoothAddressAsync ne trouve pas l’appareil identifié par bluetoothAddress. Plus précisément, si l’appareil n’est pas appairé et qu’il est introuvable dans le cache système. Vous pouvez remplir le cache d’un appareil non jumelé à l’aide des API observateur de publication LE (BluetoothLEAdvertisementWatcher) ou des API d’énumération d’appareil (GetDeviceSelectorFromPairingState) pour rechercher les appareils Bluetooth avant que FromBluetoothAddressAsync puisse être utilisé avec succès.

Attributs

RemoteAsyncAttribute OverloadAttribute

Configuration requise pour Windows

Fonctionnalités de l’application

bluetooth

Remarques

La création d’un objet BluetoothLEDevice en appelant cette méthode seule n’initie pas (nécessairement) une connexion. Pour lancer une connexion, définissez GattSession.MaintainConnectiontruesur , ou appelez une méthode de découverte de service non mise en cache sur BluetoothLEDevice, ou effectuez une opération de lecture/écriture sur l’appareil.

• Si GattSession.MaintainConnection a la valeur true, le système attend indéfiniment une connexion et se connecte lorsque l’appareil est disponible. Votre application n’a rien à attendre, car GattSession.MaintainConnection est une propriété.
• Pour les opérations de découverte de service et de lecture/écriture dans GATT, le système attend une durée limitée mais variable. N’importe quoi de l’instantané à quelques minutes. Les facteurs incluent le trafic sur la pile et la façon dont la demande est mise en file d’attente. S’il n’y a aucune autre demande en attente et que l’appareil distant est inaccessible, le système attend 7 secondes avant d’expirer. S’il existe d’autres demandes en attente, le traitement de chacune des demandes dans la file d’attente peut prendre 7 secondes, de sorte que plus le vôtre est loin à l’arrière de la file d’attente, plus vous attendez longtemps.

Vous ne pouvez pas annuler le processus de connexion.

Voir aussi

• FromBluetoothAddressAsync(UInt64, BluetoothAddressType)

FromBluetoothAddressAsync(UInt64, BluetoothAddressType)

Renvoie un objet BluetoothLEDevice représentant l’appareil homologue avec l’adresse et le type d’adresse donnés. Consultez Remarques (dans cette rubrique membre).

public:
 static IAsyncOperation<BluetoothLEDevice ^> ^ FromBluetoothAddressAsync(unsigned long long bluetoothAddress, BluetoothAddressType bluetoothAddressType);

/// [Windows.Foundation.Metadata.Overload("FromBluetoothAddressWithBluetoothAddressTypeAsync")]
/// [Windows.Foundation.Metadata.RemoteAsync]
 static IAsyncOperation<BluetoothLEDevice> FromBluetoothAddressAsync(uint64_t const& bluetoothAddress, BluetoothAddressType const& bluetoothAddressType);

[Windows.Foundation.Metadata.Overload("FromBluetoothAddressWithBluetoothAddressTypeAsync")]
[Windows.Foundation.Metadata.RemoteAsync]
public static IAsyncOperation<BluetoothLEDevice> FromBluetoothAddressAsync(ulong bluetoothAddress, BluetoothAddressType bluetoothAddressType);

function fromBluetoothAddressAsync(bluetoothAddress, bluetoothAddressType)

Public Shared Function FromBluetoothAddressAsync (bluetoothAddress As ULong, bluetoothAddressType As BluetoothAddressType) As IAsyncOperation(Of BluetoothLEDevice)

Paramètres

bluetoothAddress

UInt64

unsigned long long

uint64_t

Valeur BluetoothAddress contenant l’adresse 64 bits de l’appareil Bluetooth LE homologue.

bluetoothAddressType

BluetoothAddressType

Valeur BluetoothAddressType contenant le type d’adresse de l’appareil Bluetooth LE homologue.

Retours

IAsyncOperation<BluetoothLEDevice>

Retourne un objet représentant une opération asynchrone. Une fois cet objet terminé, il contient un objet BluetoothLEDevice représentant l’appareil homologue avec l’adresse et le type d’adresse donnés.

Important

Le BluetoothLEDevice retourné est défini sur null si FromBluetoothAddressAsync ne trouve pas l’appareil identifié par bluetoothAddress. Plus précisément, si l’appareil n’est pas appairé et qu’il est introuvable dans le cache système. Vous pouvez remplir le cache d’un appareil non jumelé à l’aide des API observateur de publication LE (BluetoothLEAdvertisementWatcher) ou des API d’énumération d’appareil (GetDeviceSelectorFromPairingState) pour rechercher les appareils Bluetooth avant que FromBluetoothAddressAsync puisse être utilisé avec succès.

Attributs

OverloadAttribute RemoteAsyncAttribute

Configuration requise pour Windows

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

Remarques

La création d’un objet BluetoothLEDevice en appelant cette méthode seule n’initie pas (nécessairement) une connexion. Pour lancer une connexion, définissez GattSession.MaintainConnectiontruesur , ou appelez une méthode de découverte de service non mise en cache sur BluetoothLEDevice, ou effectuez une opération de lecture/écriture sur l’appareil.

• Si GattSession.MaintainConnection a la valeur true, le système attend indéfiniment une connexion et se connecte lorsque l’appareil est disponible. Votre application n’a rien à attendre, car GattSession.MaintainConnection est une propriété.
• Pour les opérations de découverte de service et de lecture/écriture dans GATT, le système attend une durée limitée mais variable. N’importe quoi de l’instantané à quelques minutes. Les facteurs incluent le trafic sur la pile et la façon dont la demande est mise en file d’attente. S’il n’y a aucune autre demande en attente et que l’appareil distant est inaccessible, le système attend 7 secondes avant d’expirer. S’il existe d’autres demandes en attente, le traitement de chacune des demandes dans la file d’attente peut prendre 7 secondes, de sorte que plus le vôtre est loin à l’arrière de la file d’attente, plus vous attendez longtemps.

Actuellement, vous ne pouvez pas annuler le processus de connexion.

Voir aussi

• FromBluetoothAddressAsync(UInt64)