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
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 true
o 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 true
o 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.