BluetoothLEDevice.FromBluetoothAddressAsync Metodo

Definizione

Overload

FromBluetoothAddressAsync(UInt64)

Restituisce un oggetto BluetoothLEDevice che rappresenta il dispositivo Bluetooth LE peer con l'indirizzo specificato. Vedere Osservazioni (in questo argomento membro).

FromBluetoothAddressAsync(UInt64, BluetoothAddressType)

Restituisce un oggetto BluetoothLEDevice che rappresenta il dispositivo peer con l'indirizzo e il tipo di indirizzo specificati. Vedere Osservazioni (in questo argomento membro).

FromBluetoothAddressAsync(UInt64)

Restituisce un oggetto BluetoothLEDevice che rappresenta il dispositivo Bluetooth LE peer con l'indirizzo specificato. Vedere Osservazioni (in questo argomento 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)

Parametri

bluetoothAddress
UInt64

unsigned long long

uint64_t

Valore BluetoothAddress contenente l'indirizzo a 64 bit del dispositivo Bluetooth LE peer.

Restituisce

Restituisce un oggetto che rappresenta un'operazione asincrona. Al termine dell'oggetto, contiene un oggetto BluetoothLEDevice che rappresenta il dispositivo Bluetooth LE peer con l'indirizzo specificato.

Importante

Il bluetoothLEDevice restituito è impostato su null se FromBluetoothAddressAsync non riesce a trovare il dispositivo identificato da bluetoothAddress. In particolare, se il dispositivo non è associato e non viene trovato nella cache di sistema. È possibile popolare la cache per un dispositivo non associato usando le API di controllo dell'annuncio LE (BluetoothLEAdvertisementWatcher) o le API di enumerazione del dispositivo (GetDeviceSelectorFromPairingState) per eseguire l'analisi dei dispositivi Bluetooth prima che sia possibile usare FromBluetoothAddressAsync .

Attributi

Requisiti Windows

Funzionalità dell'app
bluetooth

Commenti

La creazione di un oggetto BluetoothLEDevice chiamando questo metodo da solo non avvia necessariamente una connessione. Per avviare una connessione, impostare GattSession.MaintainConnection su trueo chiamare un metodo di individuazione del servizio non memorizzato in BluetoothLEDevice oppure eseguire un'operazione di lettura/scrittura sul dispositivo.

  • Se GattSession.MaintainConnection è impostato su true, il sistema attende in modo indefinito una connessione e si connette al momento della disponibilità del dispositivo. Non è possibile attendere l'attesa dell'applicazione, poiché GattSession.MaintainConnection è una proprietà.
  • Per le operazioni di individuazione dei servizi e lettura/scrittura in GATT, il sistema attende un tempo limitato ma variabile. Qualsiasi cosa da istantaneo a una questione di minuti. I fattori includono il traffico nello stack e la coda della richiesta. Se non sono presenti altre richieste in sospeso e il dispositivo remoto non è raggiungibile, il sistema attenderà 7 secondi prima del timeout. Se sono presenti altre richieste in sospeso, ognuna delle richieste nella coda può richiedere 7 secondi per elaborare, quindi ulteriori operazioni si trovano verso la parte posteriore della coda, più tempo si attenderà.

Non è possibile annullare il processo di connessione.

Vedi anche

Si applica a

FromBluetoothAddressAsync(UInt64, BluetoothAddressType)

Restituisce un oggetto BluetoothLEDevice che rappresenta il dispositivo peer con l'indirizzo e il tipo di indirizzo specificati. Vedere Osservazioni (in questo argomento 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)

Parametri

bluetoothAddress
UInt64

unsigned long long

uint64_t

Valore BluetoothAddress contenente l'indirizzo a 64 bit del dispositivo Bluetooth LE peer.

bluetoothAddressType
BluetoothAddressType

Valore BluetoothAddressType contenente il tipo di indirizzo del dispositivo Bluetooth LE peer.

Restituisce

Restituisce un oggetto che rappresenta un'operazione asincrona. Al termine dell'oggetto, contiene un oggetto BluetoothLEDevice che rappresenta il dispositivo peer con l'indirizzo e il tipo di indirizzo specificati.

Importante

Il bluetoothLEDevice restituito è impostato su null se FromBluetoothAddressAsync non riesce a trovare il dispositivo identificato da bluetoothAddress. In particolare, se il dispositivo non è associato e non viene trovato nella cache di sistema. È possibile popolare la cache per un dispositivo non associato usando le API di controllo dell'annuncio LE (BluetoothLEAdvertisementWatcher) o le API di enumerazione del dispositivo (GetDeviceSelectorFromPairingState) per eseguire l'analisi dei dispositivi Bluetooth prima che sia possibile usare FromBluetoothAddressAsync .

Attributi

Requisiti Windows

Famiglia di dispositivi
Windows 10 (è stato introdotto in 10.0.10586.0 - for Xbox, see UWP features that aren't yet supported on Xbox)
API contract
Windows.Foundation.UniversalApiContract (è stato introdotto in v2.0)
Funzionalità dell'app
bluetooth

Commenti

La creazione di un oggetto BluetoothLEDevice chiamando questo metodo da solo non avvia necessariamente una connessione. Per avviare una connessione, impostare GattSession.MaintainConnection su trueo chiamare un metodo di individuazione del servizio non memorizzato in BluetoothLEDevice oppure eseguire un'operazione di lettura/scrittura sul dispositivo.

  • Se GattSession.MaintainConnection è impostato su true, il sistema attende in modo indefinito una connessione e si connette al momento della disponibilità del dispositivo. Non è possibile attendere l'attesa dell'applicazione, poiché GattSession.MaintainConnection è una proprietà.
  • Per le operazioni di individuazione dei servizi e lettura/scrittura in GATT, il sistema attende un tempo limitato ma variabile. Qualsiasi cosa da istantaneo a una questione di minuti. I fattori includono il traffico nello stack e la coda della richiesta. Se non sono presenti altre richieste in sospeso e il dispositivo remoto non è raggiungibile, il sistema attenderà 7 secondi prima del timeout. Se sono presenti altre richieste in sospeso, ognuna delle richieste nella coda può richiedere 7 secondi per elaborare, quindi ulteriori operazioni si trovano verso la parte posteriore della coda, più tempo si attenderà.

Attualmente non è possibile annullare il processo di connessione.

Vedi anche

Si applica a