System.Bluetooth.TBluetoothLEDevice.BeginReliableWrite
Delphi
function BeginReliableWrite: Boolean;
C++
bool __fastcall BeginReliableWrite();
Propriétés
Type | Visibilité | Source | Unité | Parent |
---|---|---|---|---|
function | public | System.Bluetooth.pas System.Bluetooth.hpp |
System.Bluetooth | TBluetoothLEDevice |
Description
Démarre une transaction pour écrire un ensemble de caractéristiques sur un périphérique distant sous la forme d'une transaction atomique.
Pour écrire un ensemble de caractéristiques sur un périphérique distant sous la forme d'une transaction atomique :
- Pour chaque caractéristique que vous voulez modifier, assurez-vous que les descripteurs de la caractéristique incluent un descripteur de type ExtendedProperties, et que la propriété ReliableWrite de ce descripteur est définie sur
True
, ce qui signifie que la caractéristique prend en charge les opérations d'écriture fiable. - Appelez BeginReliableWrite pour démarrer la transaction.
- Appelez WriteCharacteristic autant de fois que vous le souhaitez. Le périphérique distant n'écrit pas la caractéristique, il vérifie seulement que la valeur envoyée est correcte, et met le changement en file d'attente pour une exécution atomique. Le périphérique distant déclenche cependant OnCharacteristicWrite ; gérez cet événement pour vérifier que la nouvelle valeur reçue par le périphérique distant de votre part est correcte.
- Après avoir effectué tous vos appels à WriteCharacteristic, procédez de l'une des manières suivantes :
- Appelez ExecuteReliableWrite pour exécuter la transaction atomique.
- Appelez AbortReliableWrite pour abandonner la transaction (par exemple, si vous avez reçu des données inattendues de votre gestionnaire pour OnCharacteristicWrite).
BeginReliableWrite appelle DoBeginReliableWrite.
Prise en charge de la plate-forme
Plate-forme | Prise en charge |
---|---|
Windows |
|
OS X |
|
iOS |
|
Android |
|