次の方法で共有


GattCharacteristic クラス

定義

GATT サービスの特性を表します。 GattCharacteristic オブジェクトは、特定のサービスの GATT 特性を表し、GattDeviceService オブジェクトの Characteristics プロパティから取得されます。

public ref class GattCharacteristic sealed
/// [Windows.Foundation.Metadata.ContractVersion(Windows.Foundation.UniversalApiContract, 65536)]
/// [Windows.Foundation.Metadata.MarshalingBehavior(Windows.Foundation.Metadata.MarshalingType.Agile)]
class GattCharacteristic final
/// [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 GattCharacteristic final
[Windows.Foundation.Metadata.ContractVersion(typeof(Windows.Foundation.UniversalApiContract), 65536)]
[Windows.Foundation.Metadata.MarshalingBehavior(Windows.Foundation.Metadata.MarshalingType.Agile)]
public sealed class GattCharacteristic
[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 GattCharacteristic
Public NotInheritable Class GattCharacteristic
継承
Object Platform::Object IInspectable GattCharacteristic
属性

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 GetDescriptorsAsync
1703 15063 GetDescriptorsAsync(BluetoothCacheMode)
1703 15063 GetDescriptorsForUuidAsync(Guid)
1703 15063 GetDescriptorsForUuidAsync(Guid,BluetoothCacheMode)
1703 15063 WriteClientCharacteristicConfigurationDescriptorWithResultAsync
1703 15063 WriteValueWithResultAsync(IBuffer)
1703 15063 WriteValueWithResultAsync(IBuffer,GattWriteOption)

プロパティ

AttributeHandle

Bluetooth LE デバイスで宣言されている GATT ベースの特性属性を一意に識別するために使用されるハンドルを取得します。

CharacteristicProperties

GATT プロファイルで定義されている GATT 特性プロパティを取得します。

ExtendedProperties フラグが存在する場合は、拡張特性プロパティ記述子のプロパティも表します。

PresentationFormats

集約形式記述子で指定された順序で、この GattCharacteristic に関連付けられているプレゼンテーション形式記述子の一覧を取得します。

PresentationFormat 記述子または集計形式記述子が見つからない場合、リストは空になります。

ProtectionLevel

デバイスとの空中通信に必要な GATT セキュリティ オプションを取得または設定します。

Windows では、ペアリング プロセスの一環としてデバイスで可能な最大限のセキュリティがネゴシエートされ、低いレベルのセキュリティを指定しても、既存のセキュリティ レベルは低下しません。

Service

この特性がメンバーである GattDeviceService を取得します。

UserDescription

この GattCharacteristic のわかりやすい説明を取得します。ユーザー記述記述子が存在する場合は、空の文字列になります。

Uuid

この GattCharacteristic の GATT 特性 UUID を取得します。

メソッド

ConvertShortIdToUuid(UInt16)

Bluetooth SIG で定義された短い ID を完全な GATT UUID に変換します。

重要

ConvertShortIdToUuid API は非推奨であり、今後のバージョンの Windows では使用できない可能性があります。 代わりに、 BluetoothUuidHelper.FromShortId を使用します

GetAllDescriptors()

この GattCharacteristic インスタンスに属するすべての記述子のコレクションを取得します。

重要

GetAllDescriptors API は非推奨であり、今後のバージョンの Windows では使用できない可能性があります。 代わりに、 GetDescriptorsAsync を使用します。

GetDescriptors(Guid)

指定した UUID で識別され、この GattCharacteristic インスタンスに属する記述子のベクトルを返します。

重要

GetDescriptors API は非推奨であり、今後のバージョンの Windows では使用できない可能性があります。 代わりに、 GetDescriptorsForUuidAsync を使用します

GetDescriptorsAsync()

この GattCharacteristic インスタンスの記述子を返します。

GetDescriptorsAsync(BluetoothCacheMode)

この GattCharacteristic インスタンスの指定されたキャッシュ モードを持つ記述子を返します。

GetDescriptorsForUuidAsync(Guid)

UUID が descriptorUuid と一致する記述子を返します。

GetDescriptorsForUuidAsync(Guid, BluetoothCacheMode)

UUID が descriptorUuid と指定された cacheMode と一致する記述子を返します。

ReadClientCharacteristicConfigurationDescriptorAsync()

ClientCharacteristicConfigurationDescriptor の現在の値を読み取ります。

ReadValueAsync()

Windows によって管理されている値キャッシュから読み取られた特性値を実行します。

ReadValueAsync(BluetoothCacheMode)

Windows によって管理されている値キャッシュから、またはデバイスから直接読み取られた特性値を実行します。

WriteClientCharacteristicConfigurationDescriptorAsync(GattClientCharacteristicConfigurationDescriptorValue)

ClientCharacteristicConfigurationDescriptor を Bluetooth LE デバイスに書き込み、書き込まれる値が表示または通知を表し、ValueChanged イベント ハンドラーが登録されている場合は、デバイスから ValueChanged イベントを受信できるようにします。

WriteClientCharacteristicConfigurationDescriptorWithResultAsync(GattClientCharacteristicConfigurationDescriptorValue)

ClientCharacteristicConfigurationDescriptor を Bluetooth LE デバイスに書き込み、書き込まれる値が表示または通知を表し、ValueChanged イベント ハンドラーが登録されている場合は、デバイスから ValueChanged イベントを受信できるようにします。

WriteValueAsync(IBuffer)

Bluetooth LE デバイスに特性値の書き込みを実行します。

WriteValueAsync(IBuffer, GattWriteOption)

Bluetooth LE デバイスに特性値の書き込みを実行します。

WriteValueWithResultAsync(IBuffer)

Bluetooth LE デバイスに特性値の書き込みを実行します。

WriteValueWithResultAsync(IBuffer, GattWriteOption)

Bluetooth LE デバイスに特性値の書き込みを実行します。

イベント

ValueChanged

アプリは、クライアント特性構成記述子を設定した後、デバイスから通知または表示を受信したときにイベントを受信するためにイベント ハンドラーを登録できます。

適用対象