System.Bluetooth.TBluetoothLEDevice.ExecuteReliableWrite

Delphi

function ExecuteReliableWrite: Boolean;

C++

bool __fastcall ExecuteReliableWrite();

説明

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

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

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