System.Bluetooth.Components.TBluetoothLE.ExecuteReliableWrite

Delphi

function ExecuteReliableWrite(const ADevice: TBluetoothLEDevice): Boolean;

C++

bool __fastcall ExecuteReliableWrite(System::Bluetooth::TBluetoothLEDevice* const ADevice);

説明

前に開始したトランザクションを実行して一連のキャラクタリスティックをアトミックトランザクションとして書き込む要求を指定されたリモートデバイスに送信します。要求が正常に送信された場合は True を返し、何らかの原因で要求が送信されなかった場合は False を返します。

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

BeginReliableWrite を呼び出して、トランザクションを開始します。
WriteCharacteristic を必要な回数だけ呼び出します。リモートデバイスではキャラクタリスティックを書き込みません。送信された値が正しいことを確認し、アトミックに実行できるように変更をキューに追加するだけです。ただし、リモートデバイスでは OnCharacteristicWrite が発生します。このイベントを処理して、リモートデバイスがこちらから受け取った新しい値が正しいことを確認します。
WriteCharacteristic の呼び出しがすべて終わったら、以下のいずれかを行います。
- ExecuteReliableWrite を呼び出して、アトミックトランザクションを実行します。書き込み操作が終了すると、リモートデバイスでは OnReliableWriteCompleted イベントが発生します。
- AbortReliableWrite を呼び出して、トランザクションを中止します（たとえば、予期しないデータを OnCharacteristicWrite のハンドラで受け取った場合など）。