BluetoothLEDevice.FromBluetoothAddressAsync Metode

Definisi

Ruang nama:

Windows.Devices.Bluetooth

Overload

FromBluetoothAddressAsync(UInt64)	Mengembalikan objek BluetoothLEDevice yang mewakili perangkat LE Bluetooth serekan dengan alamat yang diberikan. Lihat Komentar (dalam topik anggota ini).
FromBluetoothAddressAsync(UInt64, BluetoothAddressType)	Mengembalikan objek BluetoothLEDevice yang mewakili perangkat serekan dengan alamat dan jenis alamat yang diberikan. Lihat Komentar (dalam topik anggota ini).

FromBluetoothAddressAsync(UInt64)

Mengembalikan objek BluetoothLEDevice yang mewakili perangkat LE Bluetooth serekan dengan alamat yang diberikan. Lihat Komentar (dalam topik anggota ini).

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

Nilai BluetoothAddress yang berisi alamat 64-bit dari perangkat LE Bluetooth serekan.

Mengembalikan

IAsyncOperation<BluetoothLEDevice>

Mengembalikan objek yang mewakili operasi asinkron. Ketika objek tersebut selesai, objek tersebut berisi objek BluetoothLEDevice yang mewakili perangkat LE Bluetooth serekan dengan alamat yang diberikan.

Penting

BluetoothLEDevice yang dikembalikan diatur ke null jika FromBluetoothAddressAsync tidak dapat menemukan perangkat yang diidentifikasi oleh bluetoothAddress. Secara khusus, jika perangkat tidak dipasangkan dan tidak ditemukan di cache sistem. Anda dapat mengisi cache untuk perangkat yang tidak dipasangkan menggunakan API pengamat iklan LE (BluetoothLEAdvertisementWatcher) atau API enumerasi perangkat (GetDeviceSelectorFromPairingState) untuk memindai perangkat Bluetooth sebelum FromBluetoothAddressAsync dapat berhasil digunakan.

Atribut

RemoteAsyncAttribute OverloadAttribute

Persyaratan Windows

Kemampuan aplikasi

bluetooth

Keterangan

Membuat objek BluetoothLEDevice dengan memanggil metode ini saja tidak (harus) memulai koneksi. Untuk memulai koneksi, atur GattSession.MaintainConnection ke true, atau panggil metode penemuan layanan yang tidak di-cache di BluetoothLEDevice, atau lakukan operasi baca/tulis terhadap perangkat.

• Jika GattSession.MaintainConnection diatur ke true, maka sistem menunggu tanpa batas waktu untuk koneksi, dan itu akan terhubung ketika perangkat tersedia. Tidak ada yang perlu ditunggu oleh aplikasi Anda, karena GattSession.MaintainConnection adalah properti .
• Untuk penemuan layanan dan operasi baca/tulis di GATT, sistem menunggu waktu terbatas tetapi bervariasi. Apa saja dari seketika sampai hitungan menit. Faktor-faktornya termasuk lalu lintas pada tumpukan, dan seberapa antrean permintaan tersebut. Jika tidak ada permintaan lain yang tertunda, dan perangkat jarak jauh tidak dapat dijangkau, maka sistem akan menunggu selama 7 detik sebelum waktu habis. Jika ada permintaan lain yang tertunda, maka setiap permintaan dalam antrean dapat memakan waktu 7 detik untuk diproses, jadi semakin lanjut permintaan Anda ke bagian belakang antrean, semakin lama Anda akan menunggu.

Anda tidak dapat membatalkan proses koneksi.

Lihat juga

• FromBluetoothAddressAsync(UInt64, BluetoothAddressType)

FromBluetoothAddressAsync(UInt64, BluetoothAddressType)

Mengembalikan objek BluetoothLEDevice yang mewakili perangkat serekan dengan alamat dan jenis alamat yang diberikan. Lihat Komentar (dalam topik anggota ini).

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

Nilai BluetoothAddress yang berisi alamat 64-bit dari perangkat LE Bluetooth serekan.

bluetoothAddressType

BluetoothAddressType

Nilai BluetoothAddressType yang berisi jenis alamat perangkat LE Bluetooth serekan.

Mengembalikan

IAsyncOperation<BluetoothLEDevice>

Mengembalikan objek yang mewakili operasi asinkron. Ketika objek tersebut selesai, objek tersebut berisi objek BluetoothLEDevice yang mewakili perangkat serekan dengan alamat dan jenis alamat yang diberikan.

Penting

BluetoothLEDevice yang dikembalikan diatur ke null jika FromBluetoothAddressAsync tidak dapat menemukan perangkat yang diidentifikasi oleh bluetoothAddress. Secara khusus, jika perangkat tidak dipasangkan dan tidak ditemukan di cache sistem. Anda dapat mengisi cache untuk perangkat yang tidak dipasangkan menggunakan API pengamat iklan LE (BluetoothLEAdvertisementWatcher) atau API enumerasi perangkat (GetDeviceSelectorFromPairingState) untuk memindai perangkat Bluetooth sebelum FromBluetoothAddressAsync dapat berhasil digunakan.

Atribut

OverloadAttribute RemoteAsyncAttribute

Persyaratan Windows

Rangkaian perangkat	Windows 10 (diperkenalkan dalam 10.0.10586.0 - for Xbox, see UWP features that aren't yet supported on Xbox)
API contract	Windows.Foundation.UniversalApiContract (diperkenalkan dalam v2.0)
Kemampuan aplikasi	bluetooth

Keterangan

Membuat objek BluetoothLEDevice dengan memanggil metode ini saja tidak (harus) memulai koneksi. Untuk memulai koneksi, atur GattSession.MaintainConnection ke true, atau panggil metode penemuan layanan yang tidak di-cache di BluetoothLEDevice, atau lakukan operasi baca/tulis terhadap perangkat.

• Jika GattSession.MaintainConnection diatur ke true, maka sistem menunggu tanpa batas waktu untuk koneksi, dan itu akan terhubung ketika perangkat tersedia. Tidak ada yang perlu ditunggu oleh aplikasi Anda, karena GattSession.MaintainConnection adalah properti .
• Untuk penemuan layanan dan operasi baca/tulis di GATT, sistem menunggu waktu terbatas tetapi bervariasi. Apa saja dari seketika sampai hitungan menit. Faktor-faktornya termasuk lalu lintas pada tumpukan, dan seberapa antrean permintaan tersebut. Jika tidak ada permintaan lain yang tertunda, dan perangkat jarak jauh tidak dapat dijangkau, maka sistem akan menunggu selama 7 detik sebelum waktu habis. Jika ada permintaan lain yang tertunda, maka setiap permintaan dalam antrean dapat memakan waktu 7 detik untuk diproses, jadi semakin lanjut permintaan Anda ke bagian belakang antrean, semakin lama Anda akan menunggu.

Saat ini, Anda tidak dapat membatalkan proses koneksi.

Lihat juga

• FromBluetoothAddressAsync(UInt64)