System.Bluetooth.TBluetoothLEDevice.BeginReliableWrite

提供: RAD Studio API Documentation
移動先: 案内検索

Delphi

function BeginReliableWrite: Boolean;

C++

bool __fastcall BeginReliableWrite(void);

プロパティ

種類 可視性 ソース ユニット
function public
System.Bluetooth.pas
System.Bluetooth.hpp
System.Bluetooth TBluetoothLEDevice


説明

一連のキャラクタリスティックをリモート デバイス上に書き込むトランザクションをアトミック トランザクションとして開始します。

一連のキャラクタリスティックをリモート デバイス上にアトミック トランザクションとして書き込むには:

  1. 編集するキャラクタリスティックごとに、そのキャラクタリスティックのディスクリプタExtendedProperties という種類ディスクリプタが必ず含まれ、かつ、そのディスクリプタの ReliableWrite プロパティが必ず True になる(信頼できる書き込み操作がキャラクタリスティックでサポートされている)ようにします。
  2. BeginReliableWrite を呼び出して、トランザクションを開始します。
  3. WriteCharacteristic を必要な回数だけ呼び出します。リモート デバイスではキャラクタリスティックの書き込みは行いません。送信された値が正しいことを確認し、アトミックに実行できるよう変更をキューに追加するだけです。ただし、リモート デバイスでは OnCharacteristicWrite が発生します。このイベントを処理して、リモート デバイスがこちらから受け取った新しい値が正しいことを確認します。
  4. WriteCharacteristic の呼び出しがすべて終わったら、以下のいずれかを行います。
    • ExecuteReliableWrite を呼び出してアトミック トランザクションを実行します。
    • AbortReliableWrite を呼び出してトランザクションを中止します(たとえば OnCharacteristicWrite のハンドラで予想しないデータを受け取った場合など)。

BeginReliableWriteDoBeginReliableWrite を呼び出します。

プラットフォーム サポート

プラットフォーム サポート対象

Windows

YesC++11Feature.png

Mac OS X

iOS

Android

YesC++11Feature.png

関連項目