ReadUserDataBuffer

Cette fonction est utilisée pour lire les données contenues dans le champ Données utilisateur du protocole de communication d’usine actuellement activé. La structure de données Buffer référencée, créée par une fonction FormatInputBuffer, définit comment les données reçues sont interprétées.

ReadUserDataBuffer – Entrées

Paramètre Description
Événement

Détermine l’événement de mise à jour provoquant la lecture des données.

Ce paramètre doit être une référence à un événement avec horodatage, par exemple l’un des événements suivants : 

  • Une cellule contenant une fonction Event.
  • Une cellule contenant une fonction Button.
Tampon Spécifie une référence à une structure de données Buffer, créée par une fonction FormatInputBuffer, qui définit comment les données reçues sont interprétées.
Protocole

Indique le protocole à partir duquel les données utilisateur doivent être lues.

1 = EtherNet/IP Indique qu’EtherNet/IP est le protocole de communication d’usine activé.
2 = PROFINET Indique que PROFINET est le protocole de communication d’usine activé.
100 = par défaut Indique que le protocole de communication d’usine actuellement activé sera utilisé. Si plusieurs protocoles sont activés, le premier activé sera utilisé.
Valider la connexion Indique si la fonction doit ou non tenter de valider la connexion. Si elle est activée, la fonction renvoie #ERR si le protocole sélectionné n’a pas de connexion cyclique active.
Ordre des octets/mots

Spécifie l’ordre des bits des mots et des octets lus par la fonction.

0 = Big endian Indique que l’octet le plus important est stocké en premier, et que les suivants sont stockés dans l’ordre décroissant.
1 = Little endian Indique que l’octet le moins important est stocké en premier, et que les suivants sont stockés dans l’ordre croissant.
2 = Big endian avec interversion poids fort/ poids faible de mots de 16 bits Le style d’octet « Big Endian » est appliqué et les types de mots doubles auront leur ordre de paire de mots interverti. (Mots de 16 bits)
3 = Little endian avec interversion poids fort/ poids faible de mots de 16 bits Le style d’octet « Little Endian » est appliqué et les types de mots doubles auront leur ordre de paire de mots interverti. (Mots de 16 bits)
100 = par défaut Le paramètre par défaut est utilisé.

ReadUserDataBuffer – Sorties

Renvoie

Une structure de données UserData contenant les données envoyées par un client, ou #ERR si :

  • – l’un des paramètres d’entrée est incorrect ;
  • – une connexion avec un client n’a pas été établie ;

  • – le tampon de données n’a pas été écrit depuis l’établissement de la connexion.
Résultats Les données de la structure de données UserData sont accessibles à l’aide de la fonction GetBufferData. Pour en savoir plus, consultez la rubrique Entrée/sortie.