Поделиться через

BluetoothLEDevice.FromBluetoothAddressAsync Метод

  • Ссылка

Определение

Пространство имен:
Windows.Devices.Bluetooth

Перегрузки

FromBluetoothAddressAsync(UInt64)

Возвращает объект BluetoothLEDevice , представляющий одноранговое устройство Bluetooth LE с заданным адресом. См . примечания (в этом разделе).
FromBluetoothAddressAsync(UInt64, BluetoothAddressType)

Возвращает объект BluetoothLEDevice , представляющий одноранговое устройство с заданным адресом и типом адреса. См . примечания (в этом разделе).

FromBluetoothAddressAsync(UInt64)

Изменить

Возвращает объект BluetoothLEDevice , представляющий одноранговое устройство Bluetooth LE с заданным адресом. См . примечания (в этом разделе).

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)

Параметры

bluetoothAddress
UInt64

unsigned long long

uint64_t

Значение BluetoothAddress , содержащее 64-разрядный адрес однорангового устройства Bluetooth LE.

Возвращаемое значение

IAsyncOperation<BluetoothLEDevice>

Возвращает объект , представляющий асинхронную операцию. После завершения этого объекта он содержит объект BluetoothLEDevice , представляющий одноранговое устройство Bluetooth LE с заданным адресом.

Важно!

Возвращаемый параметр BluetoothLEDevice имеет значение null , если FromBluetoothAddressAsync не может найти устройство, определенное bluetoothAddress. В частности, если устройство не связано и не найдено в системном кэше. Кэш для непарного устройства можно заполнить с помощью API наблюдателя за объявлениями LE (BluetoothLEAdvertisementWatcher) или API перечисления устройств (GetDeviceSelectorFromPairingState), чтобы проверить наличие устройств Bluetooth до успешного использования FromBluetoothAddressAsync .

Атрибуты
RemoteAsyncAttribute OverloadAttribute

Требования к Windows

Возможности приложения
bluetooth

Комментарии

Создание объекта BluetoothLEDevice путем вызова только этого метода не обязательно инициирует подключение. Чтобы инициировать подключение, задайте для параметра GattSession.MaintainConnection значение trueили вызовите метод обнаружения некэшированных служб на BluetoothLEDevice или выполните операцию чтения и записи на устройстве.

  • Если для GattSession.MaintainConnection задано значение true, то система будет бесконечно ожидать подключения и будет подключаться, когда устройство станет доступным. Приложению нечего ждать, так как GattSession.MaintainConnection является свойством.
  • Для операций обнаружения служб и чтения и записи в GATT система ожидает конечное, но переменное время. Все, от мгновенного до считанных минут. Факторы включают трафик в стеке и способ постановки запроса в очередь. Если нет других ожидающих запросов и удаленное устройство недоступно, система будет ожидать 7 секунд, прежде чем истечет время ожидания. Если есть другие ожидающие запросы, обработка каждого из запросов в очереди может занять 7 секунд, поэтому чем дальше вы будете направляться к задней части очереди, тем дольше вы будете ждать.

Вы не можете отменить процесс подключения.

См. также раздел

Применяется к

FromBluetoothAddressAsync(UInt64, BluetoothAddressType)

Изменить

Возвращает объект BluetoothLEDevice , представляющий одноранговое устройство с заданным адресом и типом адреса. См . примечания (в этом разделе).

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)

Параметры

bluetoothAddress
UInt64

unsigned long long

uint64_t

Значение BluetoothAddress , содержащее 64-разрядный адрес однорангового устройства Bluetooth LE.

bluetoothAddressType
BluetoothAddressType

Значение BluetoothAddressType , содержащее тип адреса однорангового устройства Bluetooth LE.

Возвращаемое значение

IAsyncOperation<BluetoothLEDevice>

Возвращает объект , представляющий асинхронную операцию. После завершения этого объекта он содержит объект BluetoothLEDevice , представляющий одноранговое устройство с заданным адресом и типом адреса.

Важно!

Возвращаемый параметр BluetoothLEDevice имеет значение null , если FromBluetoothAddressAsync не может найти устройство, определенное bluetoothAddress. В частности, если устройство не связано и не найдено в системном кэше. Кэш для непарного устройства можно заполнить с помощью API наблюдателя за объявлениями LE (BluetoothLEAdvertisementWatcher) или API перечисления устройств (GetDeviceSelectorFromPairingState), чтобы проверить наличие устройств Bluetooth до успешного использования FromBluetoothAddressAsync .

Атрибуты
OverloadAttribute RemoteAsyncAttribute

Требования к Windows

Семейство устройств
Windows 10 (появилось в 10.0.10586.0 - for Xbox, see UWP features that aren't yet supported on Xbox)
API contract
Windows.Foundation.UniversalApiContract (появилось в v2.0)
Возможности приложения
bluetooth

Комментарии

Создание объекта BluetoothLEDevice путем вызова только этого метода не обязательно инициирует подключение. Чтобы инициировать подключение, задайте для параметра GattSession.MaintainConnection значение trueили вызовите метод обнаружения некэшированных служб на BluetoothLEDevice или выполните операцию чтения и записи на устройстве.

  • Если для GattSession.MaintainConnection задано значение true, то система будет бесконечно ожидать подключения и будет подключаться, когда устройство станет доступным. Приложению нечего ждать, так как GattSession.MaintainConnection является свойством.
  • Для операций обнаружения служб и чтения и записи в GATT система ожидает конечное, но переменное время. Все, от мгновенного до считанных минут. Факторы включают трафик в стеке и способ постановки запроса в очередь. Если нет других ожидающих запросов и удаленное устройство недоступно, система будет ожидать 7 секунд, прежде чем истечет время ожидания. Если есть другие ожидающие запросы, обработка каждого из запросов в очереди может занять 7 секунд, поэтому чем дальше вы будете направляться к задней части очереди, тем дольше вы будете ждать.

В настоящее время вы не можете отменить процесс подключения.

См. также раздел

Применяется к