BluetoothLEDevice.FromBluetoothAddressAsync Método

Definición

Espacio de nombres:

Windows.Devices.Bluetooth

Sobrecargas

FromBluetoothAddressAsync(UInt64)	Devuelve un objeto BluetoothLEDevice que representa el dispositivo Bluetooth LE del mismo nivel con la dirección especificada. Vea Comentarios (en este tema de miembro).
FromBluetoothAddressAsync(UInt64, BluetoothAddressType)	Devuelve un objeto BluetoothLEDevice que representa el dispositivo del mismo nivel con la dirección y el tipo de dirección especificados. Vea Comentarios (en este tema de miembro).

FromBluetoothAddressAsync(UInt64)

Devuelve un objeto BluetoothLEDevice que representa el dispositivo Bluetooth LE del mismo nivel con la dirección especificada. Vea Comentarios (en este tema de miembro).

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)

Parámetros

bluetoothAddress

UInt64

unsigned long long

uint64_t

Un valor BluetoothAddress que contiene la dirección de 64 bits del dispositivo Bluetooth LE del mismo nivel.

Devoluciones

IAsyncOperation<BluetoothLEDevice>

Devuelve un objeto que representa una operación asincrónica. Cuando se completa ese objeto, contiene un objeto BluetoothLEDevice que representa el dispositivo Bluetooth LE del mismo nivel con la dirección especificada.

Importante

El bluetoothLEDevice devuelto se establece null en si FromBluetoothAddressAsync no encuentra el dispositivo identificado por bluetoothAddress. En concreto, si el dispositivo no está emparejado y no se encuentra en la memoria caché del sistema. Puede rellenar la memoria caché de un dispositivo no emparejado mediante las API de monitor de anuncios LE (BluetoothLEAdvertisementWatcher) o las API de enumeración de dispositivos (GetDeviceSelectorFromPairingState) para buscar los dispositivos Bluetooth antes de que se pueda usar correctamente FromBluetoothAddressAsync .

Atributos

RemoteAsyncAttribute OverloadAttribute

Requisitos de Windows

Características de aplicaciones

bluetooth

Comentarios

La creación de un objeto BluetoothLEDevice llamando solo a este método no inicia (necesariamente) una conexión. Para iniciar una conexión, establezca GattSession.MaintainConnection en o llame a trueun método de detección de servicios sin almacenamiento en caché en BluetoothLEDevice o realice una operación de lectura y escritura en el dispositivo.

• Si GattSession.MaintainConnection se establece en true, el sistema espera indefinidamente una conexión y se conectará cuando el dispositivo esté disponible. No hay nada que espere la aplicación, ya que GattSession.MaintainConnection es una propiedad .
• En el caso de las operaciones de detección y lectura y escritura de servicios en GATT, el sistema espera un tiempo finito pero variable. Cualquier cosa de instantánea a cuestión de minutos. Entre los factores se incluyen el tráfico en la pila y cómo se pone en cola la solicitud. Si no hay ninguna otra solicitud pendiente y el dispositivo remoto no es accesible, el sistema esperará 7 segundos antes de que se agote el tiempo de espera. Si hay otras solicitudes pendientes, cada una de las solicitudes de la cola puede tardar 7 segundos en procesarse, por lo que cuanto más se vaya hacia la parte posterior de la cola, más tiempo esperará.

No se puede cancelar el proceso de conexión.

Consulte también

• FromBluetoothAddressAsync(UInt64, BluetoothAddressType)

FromBluetoothAddressAsync(UInt64, BluetoothAddressType)

Devuelve un objeto BluetoothLEDevice que representa el dispositivo del mismo nivel con la dirección y el tipo de dirección especificados. Vea Comentarios (en este tema de miembro).

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)

Parámetros

bluetoothAddress

UInt64

unsigned long long

uint64_t

Un valor BluetoothAddress que contiene la dirección de 64 bits del dispositivo Bluetooth LE del mismo nivel.

bluetoothAddressType

BluetoothAddressType

Valor BluetoothAddressType que contiene el tipo de dirección del dispositivo Bluetooth LE del mismo nivel.

Devoluciones

IAsyncOperation<BluetoothLEDevice>

Devuelve un objeto que representa una operación asincrónica. Cuando se completa ese objeto, contiene un objeto BluetoothLEDevice que representa el dispositivo del mismo nivel con la dirección y el tipo de dirección especificados.

Importante

El bluetoothLEDevice devuelto se establece null en si FromBluetoothAddressAsync no encuentra el dispositivo identificado por bluetoothAddress. En concreto, si el dispositivo no está emparejado y no se encuentra en la memoria caché del sistema. Puede rellenar la memoria caché de un dispositivo no emparejado mediante las API de monitor de anuncios LE (BluetoothLEAdvertisementWatcher) o las API de enumeración de dispositivos (GetDeviceSelectorFromPairingState) para buscar los dispositivos Bluetooth antes de que se pueda usar correctamente FromBluetoothAddressAsync .

Atributos

OverloadAttribute RemoteAsyncAttribute

Requisitos de Windows

Familia de dispositivos	Windows 10 (se introdujo en la versión 10.0.10586.0 - for Xbox, see UWP features that aren't yet supported on Xbox)
API contract	Windows.Foundation.UniversalApiContract (se introdujo en la versión v2.0)
Características de aplicaciones	bluetooth

Comentarios

La creación de un objeto BluetoothLEDevice llamando solo a este método no inicia (necesariamente) una conexión. Para iniciar una conexión, establezca GattSession.MaintainConnection en o llame a trueun método de detección de servicios sin almacenamiento en caché en BluetoothLEDevice o realice una operación de lectura y escritura en el dispositivo.

• Si GattSession.MaintainConnection se establece en true, el sistema espera indefinidamente una conexión y se conectará cuando el dispositivo esté disponible. No hay nada que espere la aplicación, ya que GattSession.MaintainConnection es una propiedad .
• En el caso de las operaciones de detección y lectura y escritura de servicios en GATT, el sistema espera un tiempo finito pero variable. Cualquier cosa de instantánea a cuestión de minutos. Entre los factores se incluyen el tráfico en la pila y cómo se pone en cola la solicitud. Si no hay ninguna otra solicitud pendiente y el dispositivo remoto no es accesible, el sistema esperará 7 segundos antes de que se agote el tiempo de espera. Si hay otras solicitudes pendientes, cada una de las solicitudes de la cola puede tardar 7 segundos en procesarse, por lo que cuanto más se vaya hacia la parte posterior de la cola, más tiempo esperará.

Actualmente, no se puede cancelar el proceso de conexión.

Consulte también

• FromBluetoothAddressAsync(UInt64)