BluetoothLEDevice.FromBluetoothAddressAsync Méthode

Définition

Espace de noms:: Windows.Devices.Bluetooth

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.

Surcharges

Nom	Description
FromBluetoothAddressAsync(UInt64)	Renvoie un objet BluetoothLEDevice représentant l’appareil Bluetooth LE homologue avec l’adresse donnée. Consultez les 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 les 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 les 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

BluetoothLEDevice retourné est défini null sur si FromBluetoothAddressAsync ne trouve pas l’appareil identifié par bluetoothAddress. Plus précisément, si l’appareil n’est pas associé et qu’il n’est pas trouvé dans le cache système. Vous pouvez remplir le cache d’un appareil non jumelé à l’aide des API d’observateur de publicité 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

Configuration requise	Description
Fonctionnalités de l’application	bluetooth

Remarques

La création d’un objet BluetoothLEDevice en appelant cette méthode seul 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. Il n’y a rien à attendre de la part de votre application, puisque 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 un temps fini mais variable. De l’instantané à quelques minutes. Les facteurs incluent le trafic au niveau de la pile et le degré de mise en file d’attente de la requête. S’il n’existe aucune autre demande en attente et que l’appareil distant est inaccessible, le système attendra 7 secondes avant qu’il expire. S’il existe d’autres demandes en attente, chacune des demandes de la file d’attente peut prendre 7 secondes pour traiter. Par conséquent, plus la vôtre est vers l’arrière de la file d’attente, plus vous attendez.

Vous ne pouvez pas annuler le processus de connexion.

Voir aussi

FromBluetoothAddressAsync(UInt64, BluetoothAddressType)

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 les 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

Attributs: OverloadAttribute RemoteAsyncAttribute

Configuration requise pour Windows

Configuration requise	Description
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

Si GattSession.MaintainConnection a la valeur true, le système attend indéfiniment une connexion et se connecte lorsque l’appareil est disponible. Il n’y a rien à attendre de la part de votre application, puisque 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 un temps fini mais variable. De l’instantané à quelques minutes. Les facteurs incluent le trafic au niveau de la pile et le degré de mise en file d’attente de la requête. S’il n’existe aucune autre demande en attente et que l’appareil distant est inaccessible, le système attendra 7 secondes avant qu’il expire. S’il existe d’autres demandes en attente, chacune des demandes de la file d’attente peut prendre 7 secondes pour traiter. Par conséquent, plus la vôtre est vers l’arrière de la file d’attente, plus vous attendez.

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

Voir aussi

FromBluetoothAddressAsync(UInt64)

S’applique à

Commentaires

Cette page a-t-elle été utile ?