Compartilhar via

BluetoothLEDevice.FromBluetoothAddressAsync Método

  • Referência

Definição

Namespace:
Windows.Devices.Bluetooth

Sobrecargas

FromBluetoothAddressAsync(UInt64)

Retorna um objeto BluetoothLEDevice que representa o dispositivo Bluetooth LE par com o endereço fornecido. Consulte Comentários (neste tópico de membro).
FromBluetoothAddressAsync(UInt64, BluetoothAddressType)

Retorna um objeto BluetoothLEDevice que representa o dispositivo par com o endereço e o tipo de endereço fornecidos. Consulte Comentários (neste tópico de membro).

FromBluetoothAddressAsync(UInt64)

Editar

Retorna um objeto BluetoothLEDevice que representa o dispositivo Bluetooth LE par com o endereço fornecido. Consulte Comentários (neste tópico de membro).

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)

Parâmetros

bluetoothAddress
UInt64

unsigned long long

uint64_t

Um valor BluetoothAddress que contém o endereço de 64 bits do dispositivo Bluetooth LE par.

Retornos

IAsyncOperation<BluetoothLEDevice>

Retorna um objeto que representa uma operação assíncrona. Quando esse objeto for concluído, ele conterá um objeto BluetoothLEDevice que representa o dispositivo Bluetooth LE par com o endereço fornecido.

Importante

O BluetoothLEDevice retornado será definido null como se FromBluetoothAddressAsync não conseguir localizar o dispositivo identificado por bluetoothAddress. Especificamente, se o dispositivo não estiver emparelhado e não for encontrado no cache do sistema. Você pode preencher o cache de um dispositivo não emparelhado usando as APIs do inspetor de anúncios LE (BluetoothLEAdvertisementWatcher) ou as APIs de enumeração do dispositivo (GetDeviceSelectorFromPairingState) para verificar os dispositivos Bluetooth antes que o FromBluetoothAddressAsync possa ser usado com êxito.

Atributos
RemoteAsyncAttribute OverloadAttribute

Requisitos do Windows

Funcionalidades do aplicativo
bluetooth

Comentários

Criar um objeto BluetoothLEDevice chamando esse método sozinho não inicia (necessariamente) uma conexão. Para iniciar uma conexão, defina GattSession.MaintainConnectiontruecomo ou chame um método de descoberta de serviço não cache em BluetoothLEDevice ou execute uma operação de leitura/gravação no dispositivo.

  • Se GattSession.MaintainConnection estiver definido como true, o sistema aguardará indefinidamente uma conexão e se conectará quando o dispositivo estiver disponível. Não há nada para seu aplicativo esperar, pois GattSession.MaintainConnection é uma propriedade.
  • Para operações de descoberta de serviço e leitura/gravação no GATT, o sistema aguarda um tempo finito, mas variável. Qualquer coisa, de instantâneo a questão de minutos. Os fatores incluem o tráfego na pilha e como a solicitação está enfileirada. Se não houver nenhuma outra solicitação pendente e o dispositivo remoto estiver inacessível, o sistema aguardará 7 segundos antes de atingir o tempo limite. Se houver outras solicitações pendentes, cada uma das solicitações na fila poderá levar 7 segundos para ser processada, portanto, quanto mais a sua estiver na parte de trás da fila, mais tempo você aguardará.

Não é possível cancelar o processo de conexão.

Confira também

Aplica-se a

FromBluetoothAddressAsync(UInt64, BluetoothAddressType)

Editar

Retorna um objeto BluetoothLEDevice que representa o dispositivo par com o endereço e o tipo de endereço fornecidos. Consulte Comentários (neste tópico de membro).

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

Um valor BluetoothAddress que contém o endereço de 64 bits do dispositivo Bluetooth LE par.

bluetoothAddressType
BluetoothAddressType

Um valor BluetoothAddressType que contém o tipo de endereço do dispositivo Bluetooth LE par.

Retornos

IAsyncOperation<BluetoothLEDevice>

Retorna um objeto que representa uma operação assíncrona. Quando esse objeto for concluído, ele conterá um objeto BluetoothLEDevice que representa o dispositivo par com o endereço e o tipo de endereço fornecidos.

Importante

O BluetoothLEDevice retornado será definido null como se FromBluetoothAddressAsync não conseguir localizar o dispositivo identificado por bluetoothAddress. Especificamente, se o dispositivo não estiver emparelhado e não for encontrado no cache do sistema. Você pode preencher o cache de um dispositivo não emparelhado usando as APIs do inspetor de anúncios LE (BluetoothLEAdvertisementWatcher) ou as APIs de enumeração do dispositivo (GetDeviceSelectorFromPairingState) para verificar os dispositivos Bluetooth antes que o FromBluetoothAddressAsync possa ser usado com êxito.

Atributos
OverloadAttribute RemoteAsyncAttribute

Requisitos do Windows

Família de dispositivos
Windows 10 (introduzida na 10.0.10586.0 - for Xbox, see UWP features that aren't yet supported on Xbox)
API contract
Windows.Foundation.UniversalApiContract (introduzida na v2.0)
Funcionalidades do aplicativo
bluetooth

Comentários

Criar um objeto BluetoothLEDevice chamando esse método sozinho não inicia (necessariamente) uma conexão. Para iniciar uma conexão, defina GattSession.MaintainConnectiontruecomo ou chame um método de descoberta de serviço não cache em BluetoothLEDevice ou execute uma operação de leitura/gravação no dispositivo.

  • Se GattSession.MaintainConnection estiver definido como true, o sistema aguardará indefinidamente uma conexão e se conectará quando o dispositivo estiver disponível. Não há nada para seu aplicativo esperar, pois GattSession.MaintainConnection é uma propriedade.
  • Para operações de descoberta de serviço e leitura/gravação no GATT, o sistema aguarda um tempo finito, mas variável. Qualquer coisa, de instantâneo a questão de minutos. Os fatores incluem o tráfego na pilha e como a solicitação está enfileirada. Se não houver nenhuma outra solicitação pendente e o dispositivo remoto estiver inacessível, o sistema aguardará 7 segundos antes de atingir o tempo limite. Se houver outras solicitações pendentes, cada uma das solicitações na fila poderá levar 7 segundos para ser processada, portanto, quanto mais a sua estiver na parte de trás da fila, mais tempo você aguardará.

Atualmente, você não pode cancelar o processo de conexão.

Confira também

Aplica-se a