BluetoothLEDevice.FromBluetoothAddressAsync Metodo
Definizione
Importante
Alcune informazioni sono relative alla release non definitiva del prodotto, che potrebbe subire modifiche significative prima della release definitiva. Microsoft non riconosce alcuna garanzia, espressa o implicita, in merito alle informazioni qui fornite.
Overload
| Nome | Descrizione |
|---|---|
| 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.
Valori restituiti
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 watcher degli annunci LE (BluetoothLEAdvertisementWatcher) o le API di enumerazione del dispositivo (GetDeviceSelectorFromPairingState) per cercare i dispositivi Bluetooth prima che FromBluetoothAddressAsync possa essere usato correttamente.
- Attributi
Requisiti Windows
| Requisiti | Descrizione |
|---|---|
| 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 nella cache in BluetoothLEDevice oppure eseguire un'operazione di lettura/scrittura sul dispositivo.
- Se GattSession.MaintainConnection è impostato su true, il sistema attende a tempo indeterminato una connessione e si connette quando il dispositivo è disponibile. Non c'è nulla che l'applicazione attenda, perché GattSession.MaintainConnection è una proprietà.
- Per le operazioni di individuazione e lettura/scrittura del servizio in GATT, il sistema attende un tempo finito ma variabile. Qualsiasi cosa, da istantaneo a una questione di minuti. I fattori includono il traffico nello stack e la modalità di accodamento 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 l'elaborazione, quindi l'ulteriore percorso è verso la parte posteriore della coda, maggiore sarà l'attesa.
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.
Valori restituiti
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 watcher degli annunci LE (BluetoothLEAdvertisementWatcher) o le API di enumerazione del dispositivo (GetDeviceSelectorFromPairingState) per cercare i dispositivi Bluetooth prima che FromBluetoothAddressAsync possa essere usato correttamente.
- Attributi
Requisiti Windows
| Requisiti | Descrizione |
|---|---|
| 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 nella cache in BluetoothLEDevice oppure eseguire un'operazione di lettura/scrittura sul dispositivo.
- Se GattSession.MaintainConnection è impostato su true, il sistema attende a tempo indeterminato una connessione e si connette quando il dispositivo è disponibile. Non c'è nulla che l'applicazione attenda, perché GattSession.MaintainConnection è una proprietà.
- Per le operazioni di individuazione e lettura/scrittura del servizio in GATT, il sistema attende un tempo finito ma variabile. Qualsiasi cosa, da istantaneo a una questione di minuti. I fattori includono il traffico nello stack e la modalità di accodamento 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 l'elaborazione, quindi l'ulteriore percorso è verso la parte posteriore della coda, maggiore sarà l'attesa.
Attualmente, non è possibile annullare il processo di connessione.