GattDeviceService クラス

定義

名前空間:

Windows.Devices.Bluetooth.GenericAttributeProfile

Bluetooth デバイス上の GATT プライマリ サービスを表します。 GattDeviceService クラスは、Bluetooth LE デバイス上の GATT サービスを表します。 これは、 Windows.Devices.Enumeration API を使用してデバイスを検索することによって取得されたデバイス サービス インスタンス パスを使用してインスタンス化されます。

public ref class GattDeviceService sealed : IClosable

/// [Windows.Foundation.Metadata.ContractVersion(Windows.Foundation.UniversalApiContract, 65536)]
/// [Windows.Foundation.Metadata.MarshalingBehavior(Windows.Foundation.Metadata.MarshalingType.Agile)]
/// [Windows.Foundation.Metadata.Threading(Windows.Foundation.Metadata.ThreadingModel.Both)]
class GattDeviceService final : IClosable

[Windows.Foundation.Metadata.ContractVersion(typeof(Windows.Foundation.UniversalApiContract), 65536)]
[Windows.Foundation.Metadata.MarshalingBehavior(Windows.Foundation.Metadata.MarshalingType.Agile)]
[Windows.Foundation.Metadata.Threading(Windows.Foundation.Metadata.ThreadingModel.Both)]
public sealed class GattDeviceService : System.IDisposable

Public NotInheritable Class GattDeviceService
Implements IDisposable

継承

Object Platform::Object IInspectable GattDeviceService

属性

ContractVersionAttribute MarshalingBehaviorAttribute ThreadingAttribute

実装

IClosable IDisposable

Windows の要件

デバイス ファミリ	Windows 10 (10.0.10240.0 - for Xbox, see UWP features that aren't yet supported on Xbox で導入)
API contract	Windows.Foundation.UniversalApiContract (v1.0 で導入)
アプリの機能	bluetooth

注釈

バージョン履歴

Windows のバージョン	SDK バージョン	追加された値
1703	15063	DeviceAccessInformation
1703	15063	FromIdAsync(String,GattSharingMode)
1703	15063	GetCharacteristicsAsync
1703	15063	GetCharacteristicsAsync(BluetoothCacheMode)
1703	15063	GetCharacteristicsForUuidAsync(Guid)
1703	15063	GetCharacteristicsForUuidAsync(Guid,BluetoothCacheMode)
1703	15063	GetDeviceSelectorFor BluetoothDeviceId(BluetoothDeviceId)
1703	15063	GetDeviceSelectorFor BluetoothDeviceId(BluetoothDeviceId,BluetoothCacheMode)
1703	15063	GetDeviceSelectorFor BluetoothDeviceIdAndUuid(BluetoothDeviceId,Guid)
1703	15063	GetDeviceSelectorFor BluetoothDeviceIdAndUuid(BluetoothDeviceId,Guid,BluetoothCacheMode)
1703	15063	GetIncludedServicesAsync
1703	15063	GetIncludedServicesAsync(BluetoothCacheMode)
1703	15063	GetIncludedServicesForUuidAsync(Guid)
1703	15063	GetIncludedServicesForUuidAsync(Guid,BluetoothCacheMode)
1703	15063	OpenAsync
1703	15063	RequestAccessAsync
1703	15063	Session
1703	15063	SharingMode

プロパティ

AttributeHandle	Bluetooth LE デバイスで宣言されている GATT ベースのサービス属性を一意に識別するために使用されるハンドルを取得します。
Device	現在の GattDeviceService オブジェクトに関連付けられているデバイスを記述する BluetoothLEDevice オブジェクトを取得します。 重要 デバイス API は非推奨であり、今後のバージョンの Windows では使用できない可能性があります。 代わりに、セッションを使用 します。
DeviceAccessInformation	現在の GattDeviceService オブジェクトに関連付けられているデバイス アクセス情報を取得します。
DeviceId	GattDeviceService のインスタンス化に使用される GATT サービス インスタンス パスを表す文字列を取得します。
ParentServices	このサービスの親サービスの読み取り専用リストを取得します。 重要 ParentServices API は非推奨であり、今後のバージョンの Windows では使用できない可能性があります。
Session	この GATT デバイス サービス インスタンスのセッションを取得します。
SharingMode	この GATT デバイス サービス インスタンスの共有モードを取得します。
Uuid	この GattDeviceService に関連付けられている GATT サービス UUID を取得します。

メソッド

Close()	GattDeviceService クラスに関連付けられているリソースを解放します。 これにより、他のアプリは、問題の GattDeviceService のリソースにアクセスできます。 Close オブジェクトを呼び出した後は、GattDeviceService オブジェクトを使用しないでください。代わりに、FromIdAsync メソッドを使用して新しい GattDeviceService オブジェクトをインスタンス化します。 C++ の場合は、Close を呼び出 します。 .NET 言語の場合、この Close メソッドは Dispose に投影されます。
ConvertShortIdToUuid(UInt16)	Bluetooth SIG で定義された短い ID を完全な GATT UUID に変換します。 重要 ConvertShortIdToUuid API は非推奨であり、今後のバージョンの Windows では使用できない可能性があります。 代わりに、 BluetoothUuidHelper.FromShortId を使用します。
Dispose()	アンマネージ リソースの解放またはリセットに関連付けられているアプリケーション定義のタスクを実行します。
FromIdAsync(String)	デバイス ID から新しい GattDeviceService をインスタンス化します。
FromIdAsync(String, GattSharingMode)	デバイス ID から新しい GattDeviceService オブジェクトをインスタンス化します。
GetAllCharacteristics()	この GattDeviceService インスタンスに属するすべての特性のコレクションを取得します。 重要 GetAllCharacteristics API は非推奨であり、今後のバージョンの Windows では使用できない可能性があります。 代わりに、 GetCharacteristicsAsync を使用します。
GetAllIncludedServices()	この GattDeviceService インスタンスに属するすべての含まれるサービスのコレクションを取得します。 重要 GetAllCharacteristics API は非推奨であり、今後のバージョンの Windows では使用できない可能性があります。 代わりに、 GetIncludedServicesAsync を使用します。
GetCharacteristics(Guid)	指定した UUID で識別され、この GattDeviceService インスタンスに属する特性のベクトルを返します。 重要 GetCharacteristics API は非推奨であり、今後のバージョンの Windows では使用できない可能性があります。 代わりに、 GetCharacteristicsForUuidAsync を使用します。
GetCharacteristicsAsync()	この GattDeviceService インスタンスの一部である特性を取得します。
GetCharacteristicsAsync(BluetoothCacheMode)	この GattDeviceService インスタンスの一部である特性を取得します。
GetCharacteristicsForUuidAsync(Guid)	この GattDeviceService インスタンスの一部であり、characteristicUuid に関連付けられている文字を取得します。
GetCharacteristicsForUuidAsync(Guid, BluetoothCacheMode)	この GattDeviceService インスタンスの一部であり、characteristicUuid に関連付けられている文字を取得します。
GetDeviceSelectorForBluetoothDeviceId(BluetoothDeviceId)	BluetoothDeviceId から CreateWatcher メソッドで使用するための適切な AQS フィルター文字列を作成します。
GetDeviceSelectorForBluetoothDeviceId(BluetoothDeviceId, BluetoothCacheMode)	BluetoothDeviceId から CreateWatcher メソッドで使用するための適切な AQS フィルター文字列を作成します。
GetDeviceSelectorForBluetoothDeviceIdAndUuid(BluetoothDeviceId, Guid)	BluetoothDeviceId と serviceUuid から、 CreateWatcher メソッドで使用するための適切な AQS フィルター文字列を作成します。
GetDeviceSelectorForBluetoothDeviceIdAndUuid(BluetoothDeviceId, Guid, BluetoothCacheMode)	BluetoothDeviceId と serviceUuid から、 CreateWatcher メソッドで使用するための適切な AQS フィルター文字列を作成します。
GetDeviceSelectorFromShortId(UInt16)	16 ビットの Bluetooth GATT サービス UUID から、 CreateWatcher メソッドで使用するための適切な AQS フィルター文字列を作成します。 重要 GetDeviceSelectorFromShortId API は非推奨であり、今後のバージョンの Windows では使用できない可能性があります。 代わりに、 GetDeviceSelectorFromUuid を使用します。
GetDeviceSelectorFromUuid(Guid)	Bluetooth サービス UUID から CreateWatcher メソッドで使用するための適切な AQS フィルター文字列を作成します。
GetIncludedServices(Guid)	指定した UUID で識別され、この GattDeviceService インスタンスに属する、含まれているサービスのベクターを返します。 重要 GetIncludedServices API は非推奨であり、今後のバージョンの Windows では使用できない可能性があります。 代わりに、 GetIncludedServicesForUuidAsync を使用します。
GetIncludedServicesAsync()	この GattDeviceService インスタンスに関連付けられている含まれるサービスを取得します。
GetIncludedServicesAsync(BluetoothCacheMode)	この GattDeviceService インスタンスに関連付けられている含まれるサービスを取得します。
GetIncludedServicesForUuidAsync(Guid)	この GattDeviceService インスタンスに関連付けられている serviceUuid から含まれるサービスを取得します。
GetIncludedServicesForUuidAsync(Guid, BluetoothCacheMode)	この GattDeviceService インスタンスに関連付けられている serviceUuid から含まれるサービスを取得します。
OpenAsync(GattSharingMode)	指定した sharingMode を使用して GATT デバイス サービスを開きます。
RequestAccessAsync()	GattDeviceService へのアクセスを要求します。

こちらもご覧ください

• BluetoothLEDevice
• IClosable