FB_UDPPeer - Méthode ReceiveFrom
Description fonctionnelle
Lit les données enregistrées dans le tampon de réception et les supprime du tampon si aucune erreur n'a été détectée pendant leur lecture. Un seul message est lu tout au plus, peu importe la quantité de données à lire et la taille du tampon fourni par l'application.
La valeur de retour UDINT indique le nombre d’octets écrits dans la mémoire tampon fournie par l’application.
Interface
|
Entrée |
Type de données |
Plage valide |
Description |
|---|---|---|---|
|
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.
|
|
Sortie |
Type de données |
Plage valide |
Description |
|---|---|---|---|
|
q_xDataReceived |
BOOL |
- |
Indique si un message a été reçu. |
|
q_sPeerIP |
STRING(15) |
- |
Adresse IP source de l'homologue d'où provient le message, au format STRING. |
|
q_dwPeerIP |
DWORD |
- |
L'adresse IP de l'homologue (expéditeur) sous la forme DWORD. Chaque octet représente un chiffre de l'adresse IPv4. |
|
q_uiPeerPort |
UINT |
- |
Port source d'où provient le message. |
Limites de données par appel de fonction
Selon le contrôleur, la quantité de données à déplacer dans un appel de fonction de l'une des méthodes Receive, Send ou Peek est limitée.
|
Contrôleur |
Nombre d'octets qui peuvent être déplacés en même temps |
|---|---|
|
M241, M251 |
2048 octets |
|
PacDrive LMC, M262 |
65535 octets (limite : mémoire de l'application) |