System.Bluetooth.Components.TBluetoothLE.BeginReliableWrite
Delphi
function BeginReliableWrite(const ADevice: TBluetoothLEDevice): Boolean;
C++
bool __fastcall BeginReliableWrite(System::Bluetooth::TBluetoothLEDevice* const ADevice);
Inhaltsverzeichnis
Eigenschaften
Typ | Sichtbarkeit | Quelle | Unit | Übergeordnet |
---|---|---|---|---|
function | public | System.Bluetooth.Components.pas System.Bluetooth.Components.hpp |
System.Bluetooth.Components | TBluetoothLE |
Beschreibung
Startet eine Transaktion, um einen Merkmalssatz auf das angegebene Remote-Gerät als unteilbare (atomic) Transaktion zu schreiben.
So schreiben Sie einen Merkmalssatz auf ein Remote-Gerät als unteilbare (atomic) Transaktion:
- Stellen Sie für jedes Merkmal, das Sie bearbeiten möchten, sicher, dass in den Deskriptoren des Merkmals ein Deskriptor der Art (Kind) ExtendedProperties enthalten ist und dass die Eigenschaft ReliableWrite dieses Deskriptors
True
ist. Das bedeutet, dass das Merkmal verlässliche Schreibvorgänge unterstützt. - Rufen Sie BeginReliableWrite auf, um die Transaktion zu starten.
- Rufen Sie WriteCharacteristic so oft wie gewünscht auf. Das Remote-Gerät schreibt das Merkmal nicht, es überprüft lediglich, ob der Wert korrekt gesendet wurde, und stellt die Änderung für eine unteilbare (atomic) Ausführung in die Warteschlange. Das Remote-Gerät löst allerdings OnCharacteristicWrite aus; behandeln Sie dieses Ereignis, um zu überprüfen, ob der neue vom Remote-Gerät empfangene Wert korrekt ist.
- Wenn Sie alle Aufrufe von WriteCharacteristic ausgeführt haben, führen Sie einen der folgenden Schritte durch:
- Rufen Sie ExecuteReliableWrite auf, um die unteilbare (atomic) Transaktion auszuführen.
- Rufen Sie AbortReliableWrite auf, um die Transaktion abzubrechen (z. B. wenn Sie für Ihre Behandlungsroutine für OnCharacteristicWrite unerwartete Daten erhalten haben).
BeginReliableWrite ruft TBluetoothLEDevice.BeginReliableWrite auf.
Plattformunterstützung
Plattform | Unterstützt |
---|---|
Windows |
|
OS X |
|
iOS |
|
Android |
|
Siehe auch
- System.Bluetooth.TBluetoothGattDescriptor.ReliableWrite
- System.Bluetooth.Components.TBluetoothLE.WriteCharacteristic
- System.Bluetooth.Components.TBluetoothLE.OnCharacteristicWrite
- System.Bluetooth.Components.TBluetoothLE.ExecuteReliableWrite
- System.Bluetooth.Components.TBluetoothLE.AbortReliableWrite