BluetoothLEDevice.FromBluetoothAddressAsync Methode

Definition

Namespace:

Windows.Devices.Bluetooth

Überlädt

FromBluetoothAddressAsync(UInt64)	Gibt ein BluetoothLEDevice-Objekt zurück, das das Bluetooth LE-Peergerät mit der angegebenen Adresse darstellt. Weitere Informationen finden Sie unter Hinweise (in diesem Memberthema).
FromBluetoothAddressAsync(UInt64, BluetoothAddressType)	Gibt ein BluetoothLEDevice-Objekt zurück, das das Peergerät mit der angegebenen Adresse und dem angegebenen Adresstyp darstellt. Weitere Informationen finden Sie unter Hinweise (in diesem Memberthema).

FromBluetoothAddressAsync(UInt64)

Gibt ein BluetoothLEDevice-Objekt zurück, das das Bluetooth LE-Peergerät mit der angegebenen Adresse darstellt. Weitere Informationen finden Sie unter Hinweise (in diesem Memberthema).

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)

Parameter

bluetoothAddress

UInt64

unsigned long long

uint64_t

Ein BluetoothAddress-Wert , der die 64-Bit-Adresse des Bluetooth LE-Peergeräts enthält.

Gibt zurück

IAsyncOperation<BluetoothLEDevice>

Gibt ein Objekt zurück, das einen asynchronen Vorgang darstellt. Wenn dieses Objekt abgeschlossen ist, enthält es ein BluetoothLEDevice-Objekt , das das Bluetooth LE-Peergerät mit der angegebenen Adresse darstellt.

Wichtig

Das zurückgegebene BluetoothLEDevice wird auf null festgelegt, wenn FromBluetoothAddressAsync das durch bluetoothAddress identifizierte Gerät nicht finden kann. Insbesondere, wenn das Gerät nicht gekoppelt ist und nicht im Systemcache gefunden wird. Sie können den Cache für ein nicht gekoppeltes Gerät mit den LE-Ankündigungs-Watcher-APIs (BluetoothLEAdvertisementWatcher) oder den Geräteenumer-APIs (GetDeviceSelectorFromPairingState) auffüllen, um nach den Bluetooth-Geräten zu suchen, bevor FromBluetoothAddressAsync erfolgreich verwendet werden kann.

Attribute

RemoteAsyncAttribute OverloadAttribute

Windows-Anforderungen

App-Funktionen

bluetooth

Hinweise

Durch das Erstellen eines BluetoothLEDevice-Objekts durch Aufrufen dieser Methode allein wird nicht (notwendigerweise) eine Verbindung initiiert. Um eine Verbindung zu initiieren, legen Sie GattSession.MaintainConnection auf truefest, oder rufen Sie eine nicht zwischengespeicherte Dienstermittlungsmethode auf BluetoothLEDevice auf, oder führen Sie einen Lese-/Schreibvorgang für das Gerät aus.

• Wenn GattSession.MaintainConnection auf true festgelegt ist, wartet das System unbegrenzt auf eine Verbindung, und es wird eine Verbindung hergestellt, sobald das Gerät verfügbar ist. Es gibt nichts, auf das Ihre Anwendung warten muss, da GattSession.MaintainConnection eine Eigenschaft ist.
• Bei Dienstermittlungs- und Lese-/Schreibvorgängen im GATT wartet das System auf eine begrenzte, aber variable Zeit. Alles von sofort bis zu wenigen Minuten. Zu den Faktoren gehören der Datenverkehr auf dem Stapel und die Warteschlange der Anforderung. Wenn keine andere anforderung aussteht und das Remotegerät nicht erreichbar ist, wartet das System 7 Sekunden, bevor das Zeitlimit ausfällt. Wenn weitere ausstehende Anforderungen vorhanden sind, kann die Verarbeitung der einzelnen Anforderungen in der Warteschlange 7 Sekunden dauern. Je weiter Sich Ihre Warteschlange am Ende der Warteschlange befindet, desto länger warten Sie also.

Sie können den Verbindungsvorgang nicht abbrechen.

Weitere Informationen

• FromBluetoothAddressAsync(UInt64, BluetoothAddressType)

FromBluetoothAddressAsync(UInt64, BluetoothAddressType)

Gibt ein BluetoothLEDevice-Objekt zurück, das das Peergerät mit der angegebenen Adresse und dem angegebenen Adresstyp darstellt. Weitere Informationen finden Sie unter Hinweise (in diesem Memberthema).

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)

Parameter

bluetoothAddress

UInt64

unsigned long long

uint64_t

Ein BluetoothAddress-Wert , der die 64-Bit-Adresse des Bluetooth LE-Peergeräts enthält.

bluetoothAddressType

BluetoothAddressType

Ein BluetoothAddressType-Wert , der den Adresstyp des Bluetooth LE-Peergeräts enthält.

Gibt zurück

IAsyncOperation<BluetoothLEDevice>

Gibt ein Objekt zurück, das einen asynchronen Vorgang darstellt. Wenn dieses Objekt abgeschlossen ist, enthält es ein BluetoothLEDevice-Objekt , das das Peergerät mit der angegebenen Adresse und dem angegebenen Adresstyp darstellt.

Wichtig

Das zurückgegebene BluetoothLEDevice wird auf null festgelegt, wenn FromBluetoothAddressAsync das durch bluetoothAddress identifizierte Gerät nicht finden kann. Insbesondere, wenn das Gerät nicht gekoppelt ist und nicht im Systemcache gefunden wird. Sie können den Cache für ein nicht gekoppeltes Gerät mit den LE-Ankündigungs-Watcher-APIs (BluetoothLEAdvertisementWatcher) oder den Geräteenumer-APIs (GetDeviceSelectorFromPairingState) auffüllen, um nach den Bluetooth-Geräten zu suchen, bevor FromBluetoothAddressAsync erfolgreich verwendet werden kann.

Attribute

OverloadAttribute RemoteAsyncAttribute

Windows-Anforderungen

Gerätefamilie	Windows 10 (eingeführt in 10.0.10586.0 - for Xbox, see UWP features that aren't yet supported on Xbox)
API contract	Windows.Foundation.UniversalApiContract (eingeführt in v2.0)
App-Funktionen	bluetooth

Hinweise

Durch das Erstellen eines BluetoothLEDevice-Objekts durch Aufrufen dieser Methode allein wird nicht (notwendigerweise) eine Verbindung initiiert. Um eine Verbindung zu initiieren, legen Sie GattSession.MaintainConnection auf truefest, oder rufen Sie eine nicht zwischengespeicherte Dienstermittlungsmethode auf BluetoothLEDevice auf, oder führen Sie einen Lese-/Schreibvorgang für das Gerät aus.

• Wenn GattSession.MaintainConnection auf true festgelegt ist, wartet das System unbegrenzt auf eine Verbindung, und es wird eine Verbindung hergestellt, sobald das Gerät verfügbar ist. Es gibt nichts, auf das Ihre Anwendung warten muss, da GattSession.MaintainConnection eine Eigenschaft ist.
• Bei Dienstermittlungs- und Lese-/Schreibvorgängen im GATT wartet das System auf eine begrenzte, aber variable Zeit. Alles von sofort bis zu wenigen Minuten. Zu den Faktoren gehören der Datenverkehr auf dem Stapel und die Warteschlange der Anforderung. Wenn keine andere anforderung aussteht und das Remotegerät nicht erreichbar ist, wartet das System 7 Sekunden, bevor das Zeitlimit ausfällt. Wenn weitere ausstehende Anforderungen vorhanden sind, kann die Verarbeitung der einzelnen Anforderungen in der Warteschlange 7 Sekunden dauern. Je weiter Sich Ihre Warteschlange am Ende der Warteschlange befindet, desto länger warten Sie also.

Derzeit können Sie den Verbindungsvorgang nicht abbrechen.

Weitere Informationen

• FromBluetoothAddressAsync(UInt64)