BluetoothLEDevice.FromBluetoothAddressAsync 方法

定義

命名空間:

Windows.Devices.Bluetooth

多載

FromBluetoothAddressAsync(UInt64)	會傳回 BluetoothLEDevice 物件，代表具有指定位址的對等藍牙 LE 裝置。 See Remarks (in this member topic).
FromBluetoothAddressAsync(UInt64, BluetoothAddressType)	會傳回 BluetoothLEDevice 物件，代表具有指定位址和網址類別型的對等裝置。 See Remarks (in this member topic).

FromBluetoothAddressAsync(UInt64)

會傳回 BluetoothLEDevice 物件，代表具有指定位址的對等藍牙 LE 裝置。 See Remarks (in this member topic).

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) 或裝置列舉 API (GetDeviceSelectorFromPairingState) 填入非配對裝置的快取，以在 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 物件，代表具有指定位址和網址類別型的對等裝置。 See Remarks (in this member topic).

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) 或裝置列舉 API (GetDeviceSelectorFromPairingState) 填入非配對裝置的快取，以在 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)