Partager via

BluetoothLEDevice.FromBluetoothAddressAsync Méthode

  • Référence

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)

Modifier

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]
 static IAsyncOperation<BluetoothLEDevice> FromBluetoothAddressAsync(uint64_t const& bluetoothAddress);
/// [Windows.Foundation.Metadata.RemoteAsync]
/// [Windows.Foundation.Metadata.Overload("FromBluetoothAddressAsync")]
 static IAsyncOperation<BluetoothLEDevice> FromBluetoothAddressAsync(uint64_t const& bluetoothAddress);
[Windows.Foundation.Metadata.RemoteAsync]
public static IAsyncOperation<BluetoothLEDevice> FromBluetoothAddressAsync(ulong 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

S’applique à

FromBluetoothAddressAsync(UInt64, BluetoothAddressType)

Modifier

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

S’applique à