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 オブジェクトが含まれます。

重要

From BluetoothAddressAsync で bluetoothAddress で識別されたデバイスが見つからない場合、返される BluetoothLEDevice は にnull設定されます。 具体的には、デバイスがペアリングされておらず、システム キャッシュに見つからない場合です。 ペアリングされていないデバイスのキャッシュには、LE アドバタイズ ウォッチャー API (BluetoothLEAdvertisementWatcher) またはデバイス列挙 API (GetDeviceSelectorFromPairingState) を使用して、 From BluetoothAddressAsync を正常に使用する前に Bluetooth デバイスをスキャンできます。

属性

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 オブジェクトが含まれます。

重要

From BluetoothAddressAsync で bluetoothAddress で識別されたデバイスが見つからない場合、返される BluetoothLEDevice は にnull設定されます。 具体的には、デバイスがペアリングされておらず、システム キャッシュに見つからない場合です。 ペアリングされていないデバイスのキャッシュには、LE アドバタイズ ウォッチャー API (BluetoothLEAdvertisementWatcher) またはデバイス列挙 API (GetDeviceSelectorFromPairingState) を使用して、 From BluetoothAddressAsync を正常に使用する前に Bluetooth デバイスをスキャンできます。

属性

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)