Méthode ReceiveOutOfBandFromSpecificClient

Présentation

Type :

Méthode

Disponible à partir de :

V1.0.4.0

Tâche

Lire les données OutOfBand enregistrées dans le tampon de réception du client identifié par une adresse IP et un port source

Description fonctionnelle

Lit les données OutOfBand enregistrées dans le tampon de réception du client identifié par une adresse IP et un port source et les supprime du tampon si aucune erreur n'a été détectée pendant leur lecture.

La valeur de retour UDINT indique le nombre d’octets écrits dans la mémoire tampon fournie par l’application.

Pour plus d'informations sur les méthodes de réception, consultez la section Méthode de réception.

Interface

Entrée

Type de données

Plage valide

Description

i_sClientIP

STRING(15)

-

Adresse IP du client connecté à partir duquel les données doivent être lues.

i_uiClientPort

UINT

1…65 535

Port source du client connecté à partir duquel les données doivent être lues.

i_pbyReceiveBuffer

POINTER TO BYTE

-

Adresse de départ du tampon à partir de laquelle les données reçues doivent être écrites.

i_udiReceiveBufferSize

UDINT

1…2 147 483 647

Nombre d’octets à lire.

NOTE : La valeur ne doit pas dépasser la taille de la mémoire tampon.
NOTE : Pour empêcher tout accès non autorisé, par exemple un accès de pointeur (hors limites) dans la mémoire, utilisez l'opérateur arithmétique SIZEOF avec le tampon cible pour déterminer la valeur de i_udiReceiveBufferSize.

In_Out

Type de données

Plage valide

Description

iq_udiFillLevel

UDINT

1…2 147 483 647

Indique le niveau de remplissage du tampon.

Avant l’appel de la fonction :

Les données sont écrites à partir de ce point.

Après l’appel de la fonction :

Mise à jour en ajoutant le nombre d’octets écrits sur la valeur d’origine.

Utilisé par

  • FB_TCPServer