BluetoothLEDevice.FromBluetoothAddressAsync 메서드

정의

네임스페이스:

Windows.Devices.Bluetooth

오버로드

FromBluetoothAddressAsync(UInt64)	지정된 주소가 있는 피어 Bluetooth LE 디바이스를 나타내는 BluetoothLEDevice 개체를 반환합니다. 설명(이 멤버 항목에서)을 참조하세요.
FromBluetoothAddressAsync(UInt64, BluetoothAddressType)	지정된 주소 및 주소 형식의 피어 디바이스를 나타내는 BluetoothLEDevice 개체를 반환합니다. 설명(이 멤버 항목에서)을 참조하세요.

FromBluetoothAddressAsync(UInt64)

지정된 주소가 있는 피어 Bluetooth LE 디바이스를 나타내는 BluetoothLEDevice 개체를 반환합니다. 설명(이 멤버 항목에서)을 참조하세요.

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)

매개 변수

bluetoothAddress

UInt64

unsigned long long

uint64_t

피어 Bluetooth LE 디바이스의 64비트 주소를 포함하는 BluetoothAddress 값입니다.

반환

IAsyncOperation<BluetoothLEDevice>

비동기 작업을 나타내는 개체를 반환합니다. 해당 개체가 완료되면 지정된 주소가 있는 피어 Bluetooth LE 디바이스를 나타내는 BluetoothLEDevice 개체가 포함됩니다.

중요

FromBluetoothAddressAsync에서 bluetoothAddress로 null 식별된 디바이스를 찾을 수 없는 경우 반환된 BluetoothLEDevice가 로 설정됩니다. 특히 디바이스가 페어링되지 않고 시스템 캐시에 없는 경우입니다. FROMBluetoothAddressAsync를 성공적으로 사용하기 전에 LE 광고 감시자 API(BluetoothLEAdvertisementWatcher) 또는 디바이스 열거형 API(GetDeviceSelectorFromPairingState)를 사용하여 페어링되지 않은 디바이스에 대한 캐시를 채울 수 있습니다.

특성

RemoteAsyncAttribute OverloadAttribute

Windows 요구 사항

앱 기능

bluetooth

설명

이 메서드만 호출하여 BluetoothLEDevice 개체를 만든다고 해서 반드시 연결을 시작하는 것은 아닙니다. 연결을 시작하려면 GattSession.MaintainConnection을 true로 설정하거나, BluetoothLEDevice에서 캐시되지 않은 서비스 검색 메서드를 호출하거나, 디바이스에 대해 읽기/쓰기 작업을 수행합니다.

• GattSession.MaintainConnection이 true로 설정된 경우 시스템은 연결을 무기한 대기하고 디바이스를 사용할 수 있을 때 연결됩니다. GattSession.MaintainConnection이 속성이므로 애플리케이션에서 기다릴 것이 없습니다.
• GATT에서 서비스 검색 및 읽기/쓰기 작업의 경우 시스템은 유한하지만 가변적인 시간을 기다립니다. 순간적인 것에서 몇 분에 이르기까지의 모든 것. 요인에는 스택의 트래픽과 요청이 대기 중인 방법이 포함됩니다. 보류 중인 다른 요청이 없고 원격 디바이스에 연결할 수 없는 경우 시스템은 시간이 초과되기 전에 7초 동안 대기합니다. 보류 중인 다른 요청이 있는 경우 큐의 각 요청을 처리하는 데 7초가 걸릴 수 있으므로 큐 뒤쪽으로 더 오래 대기할수록 더 오래 기다릴 수 있습니다.

연결 프로세스를 취소할 수 없습니다.

추가 정보

• FromBluetoothAddressAsync(UInt64, BluetoothAddressType)

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

피어 Bluetooth LE 디바이스의 64비트 주소를 포함하는 BluetoothAddress 값입니다.

bluetoothAddressType

BluetoothAddressType

피어 Bluetooth LE 디바이스의 주소 유형을 포함하는 BluetoothAddressType 값입니다.

반환

IAsyncOperation<BluetoothLEDevice>

비동기 작업을 나타내는 개체를 반환합니다. 해당 개체가 완료되면 지정된 주소 및 주소 형식의 피어 디바이스를 나타내는 BluetoothLEDevice 개체가 포함됩니다.

중요

FromBluetoothAddressAsync에서 bluetoothAddress로 null 식별된 디바이스를 찾을 수 없는 경우 반환된 BluetoothLEDevice가 로 설정됩니다. 특히 디바이스가 페어링되지 않고 시스템 캐시에 없는 경우입니다. FROMBluetoothAddressAsync를 성공적으로 사용하기 전에 LE 광고 감시자 API(BluetoothLEAdvertisementWatcher) 또는 디바이스 열거형 API(GetDeviceSelectorFromPairingState)를 사용하여 페어링되지 않은 디바이스에 대한 캐시를 채울 수 있습니다.

특성

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초가 걸릴 수 있으므로 큐 뒤쪽으로 더 오래 대기할수록 더 오래 기다릴 수 있습니다.

현재 연결 프로세스를 취소할 수 없습니다.

추가 정보

• FromBluetoothAddressAsync(UInt64)