BluetoothLEDevice.FromBluetoothAddressAsync 方法

定义

命名空间:

Windows.Devices.Bluetooth

重载

FromBluetoothAddressAsync(UInt64)	返回一个 BluetoothLEDevice 对象，该对象表示具有给定地址的对等蓝牙 LE 设备。 请参阅此成员主题) 中的 备注 (。
FromBluetoothAddressAsync(UInt64, BluetoothAddressType)	返回一个 BluetoothLEDevice 对象，该对象表示具有给定地址和地址类型的对等设备。 请参阅此成员主题) 中的 备注 (。

FromBluetoothAddressAsync(UInt64)

返回一个 BluetoothLEDevice 对象，该对象表示具有给定地址的对等蓝牙 LE 设备。 请参阅此成员主题) 中的 备注 (。

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)

参数

bluetoothAddress

UInt64

unsigned long long

uint64_t

一个 BluetoothAddress 值，该值包含对等蓝牙 LE 设备的 64 位地址。

返回

IAsyncOperation<BluetoothLEDevice>

返回表示异步操作的 对象。 该对象完成后，它将包含一个 BluetoothLEDevice 对象，该对象表示具有给定地址的对等蓝牙 LE 设备。

重要

如果 FromBluetoothAddressAsync 找不到 bluetoothAddress 标识的设备，则返回的 BluetoothLEDevice 设置为 null 。 具体而言，如果设备未配对，并且系统缓存中未找到该设备。 可以使用 LE 播发观察程序 API (BluetoothLEAdvertisementWatcher) ，或者使用 GetDeviceSelectorFromPairingState) 的设备枚举 (API 填充非配对设备的缓存，以便在成功使用 FromBluetoothAddressAsync 之前扫描蓝牙设备。

属性

RemoteAsyncAttribute OverloadAttribute

Windows 要求

应用功能

bluetooth

注解

通过单独调用此方法创建 BluetoothLEDevice 对象不（一定）会启动连接。 若要启动连接，请将 GattSession.MaintainConnection 设置为 true，或在 BluetoothLEDevice 上调用未缓存的服务发现方法，或对设备执行读/写操作。

• 如果将 GattSession.MaintainConnection 设置为 true，则系统会无限期地等待连接，并在设备可用时连接。 应用程序无需等待，因为 GattSession.MaintainConnection 是一个属性。
• 对于 GATT 中的服务发现和读/写操作，系统会等待有限但可变的时间。 从瞬间到几分钟的任何内容。 因素包括堆栈上的流量，以及请求的排队方式。 如果没有其他挂起的请求，并且无法访问远程设备，则系统将等待 7 秒，然后才超时。如果存在其他挂起的请求，则队列中的每个请求可能需要 7 秒来处理，因此，你的请求越接近队列的后面，等待的时间就越长。

无法取消连接过程。

另请参阅

• FromBluetoothAddressAsync(UInt64, BluetoothAddressType)

FromBluetoothAddressAsync(UInt64, BluetoothAddressType)

返回一个 BluetoothLEDevice 对象，该对象表示具有给定地址和地址类型的对等设备。 请参阅此成员主题) 中的 备注 (。

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)

参数

bluetoothAddress

UInt64

unsigned long long

uint64_t

一个 BluetoothAddress 值，该值包含对等蓝牙 LE 设备的 64 位地址。

bluetoothAddressType

BluetoothAddressType

一个 BluetoothAddressType 值，该值包含对等蓝牙 LE 设备的地址类型。

返回

IAsyncOperation<BluetoothLEDevice>

返回表示异步操作的 对象。 该对象完成后，它将包含一个 BluetoothLEDevice 对象，该对象表示具有给定地址和地址类型的对等设备。

重要

如果 FromBluetoothAddressAsync 找不到 bluetoothAddress 标识的设备，则返回的 BluetoothLEDevice 设置为 null 。 具体而言，如果设备未配对，并且系统缓存中未找到该设备。 可以使用 LE 播发观察程序 API (BluetoothLEAdvertisementWatcher) ，或者使用 GetDeviceSelectorFromPairingState) 的设备枚举 (API 填充非配对设备的缓存，以便在成功使用 FromBluetoothAddressAsync 之前扫描蓝牙设备。

属性

OverloadAttribute RemoteAsyncAttribute

Windows 要求

设备系列	Windows 10 (在 10.0.10586.0 - for Xbox, see UWP features that aren't yet supported on Xbox 中引入)
API contract	Windows.Foundation.UniversalApiContract (在 v2.0 中引入)
应用功能	bluetooth

注解

通过单独调用此方法创建 BluetoothLEDevice 对象不（一定）会启动连接。 若要启动连接，请将 GattSession.MaintainConnection 设置为 true，或在 BluetoothLEDevice 上调用未缓存的服务发现方法，或对设备执行读/写操作。

• 如果将 GattSession.MaintainConnection 设置为 true，则系统会无限期地等待连接，并在设备可用时连接。 应用程序无需等待，因为 GattSession.MaintainConnection 是一个属性。
• 对于 GATT 中的服务发现和读/写操作，系统会等待有限但可变的时间。 从瞬间到几分钟的任何内容。 因素包括堆栈上的流量，以及请求的排队方式。 如果没有其他挂起的请求，并且无法访问远程设备，则系统将等待 7 秒，然后才超时。如果存在其他挂起的请求，则队列中的每个请求可能需要 7 秒来处理，因此，你的请求越接近队列的后面，等待的时间就越长。

当前无法取消连接进程。

另请参阅

• FromBluetoothAddressAsync(UInt64)