BluetoothLEDevice.FromBluetoothAddressAsync 메서드
정의
중요
일부 정보는 릴리스되기 전에 상당 부분 수정될 수 있는 시험판 제품과 관련이 있습니다. Microsoft는 여기에 제공된 정보에 대해 어떠한 명시적이거나 묵시적인 보증도 하지 않습니다.
오버로드
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]
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
피어 Bluetooth LE 디바이스의 64비트 주소를 포함하는 BluetoothAddress 값입니다.
반환
비동기 작업을 나타내는 개체를 반환합니다. 해당 개체가 완료되면 지정된 주소가 있는 피어 Bluetooth LE 디바이스를 나타내는 BluetoothLEDevice 개체가 포함됩니다.
중요
FromBluetoothAddressAsync에서 bluetoothAddress로 null
식별된 디바이스를 찾을 수 없는 경우 반환된 BluetoothLEDevice가 로 설정됩니다. 특히 디바이스가 페어링되지 않고 시스템 캐시에 없는 경우입니다. FROMBluetoothAddressAsync를 성공적으로 사용하기 전에 LE 광고 감시자 API(BluetoothLEAdvertisementWatcher) 또는 디바이스 열거형 API(GetDeviceSelectorFromPairingState)를 사용하여 페어링되지 않은 디바이스에 대한 캐시를 채울 수 있습니다.
- 특성
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
피어 Bluetooth LE 디바이스의 64비트 주소를 포함하는 BluetoothAddress 값입니다.
- bluetoothAddressType
- BluetoothAddressType
피어 Bluetooth LE 디바이스의 주소 유형을 포함하는 BluetoothAddressType 값입니다.
반환
비동기 작업을 나타내는 개체를 반환합니다. 해당 개체가 완료되면 지정된 주소 및 주소 형식의 피어 디바이스를 나타내는 BluetoothLEDevice 개체가 포함됩니다.
중요
FromBluetoothAddressAsync에서 bluetoothAddress로 null
식별된 디바이스를 찾을 수 없는 경우 반환된 BluetoothLEDevice가 로 설정됩니다. 특히 디바이스가 페어링되지 않고 시스템 캐시에 없는 경우입니다. FROMBluetoothAddressAsync를 성공적으로 사용하기 전에 LE 광고 감시자 API(BluetoothLEAdvertisementWatcher) 또는 디바이스 열거형 API(GetDeviceSelectorFromPairingState)를 사용하여 페어링되지 않은 디바이스에 대한 캐시를 채울 수 있습니다.
- 특성
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초가 걸릴 수 있으므로 큐 뒤쪽으로 더 오래 대기할수록 더 오래 기다릴 수 있습니다.
현재 연결 프로세스를 취소할 수 없습니다.