System.Bluetooth.TBluetoothLEDevice.BeginReliableWrite
Delphi
function BeginReliableWrite: Boolean;
C++
bool __fastcall BeginReliableWrite(void);
プロパティ
種類 | 可視性 | ソース | ユニット | 親 |
---|---|---|---|---|
function | public | System.Bluetooth.pas System.Bluetooth.hpp |
System.Bluetooth | TBluetoothLEDevice |
説明
一連のキャラクタリスティックをリモート デバイス上に書き込むトランザクションをアトミック トランザクションとして開始します。
一連のキャラクタリスティックをリモート デバイス上にアトミック トランザクションとして書き込むには:
- 編集するキャラクタリスティックごとに、そのキャラクタリスティックのディスクリプタに ExtendedProperties という種類のディスクリプタが必ず含まれ、かつ、そのディスクリプタの ReliableWrite プロパティが必ず
True
になる(信頼できる書き込み操作がキャラクタリスティックでサポートされている)ようにします。 - BeginReliableWrite を呼び出して、トランザクションを開始します。
- WriteCharacteristic を必要な回数だけ呼び出します。リモート デバイスではキャラクタリスティックの書き込みは行いません。送信された値が正しいことを確認し、アトミックに実行できるよう変更をキューに追加するだけです。ただし、リモート デバイスでは OnCharacteristicWrite が発生します。このイベントを処理して、リモート デバイスがこちらから受け取った新しい値が正しいことを確認します。
- WriteCharacteristic の呼び出しがすべて終わったら、以下のいずれかを行います。
- ExecuteReliableWrite を呼び出してアトミック トランザクションを実行します。
- AbortReliableWrite を呼び出してトランザクションを中止します(たとえば OnCharacteristicWrite のハンドラで予想しないデータを受け取った場合など)。
BeginReliableWrite は DoBeginReliableWrite を呼び出します。
プラットフォーム サポート
プラットフォーム | サポート対象 |
---|---|
Windows |
|
Mac OS X |
|
iOS |
|
Android |
|