ReceiveOutOfBandFromFirstAvailableClient 方法

概述

类型：	方法
适用的版本：	V1.0.4.0

读取具有数据可读的第一个客户端的接收缓冲区中存储的 OutOfBand 数据。

读取具有数据可读的第一个客户端的接收缓冲区中存储的 OutOfBand 数据，如果读取完数据后没有检测到错误，并移除数据。

UDINT 返回值指示写入到应用程序提供的缓冲区中的字节数。

有关接收方法的其他信息，请参阅接收方法。

输入	数据类型	有效范围	描述
i_pbyReceiveBuffer	POINTER TO BYTE	-	接收到的数据所写入的缓冲区的起始地址。
i_udiReceiveBufferSize	UDINT	1 ... 2147483647	要读取的字节数。注：这个值不得大于缓冲区的大小。

注：为了防止因存储器指针访问无效（在范围外）引起的非法访问，利用算术运算符 SIZEOF 和目标缓冲区来确定 i_udiReceiveBufferSize 的值。

In_Out	数据类型	有效范围	描述
iq_udiFillLevel	UDINT	1 ... 2147483647	指示缓冲区的填充水平。功能调用前：将从这个偏移开始写入数据。功能调用后：通过将写入的字节数添加到原始值来更新。

In_Out

数据类型

有效范围

描述

iq_udiFillLevel

UDINT

1 ... 2147483647

指示缓冲区的填充水平。

功能调用前：

将从这个偏移开始写入数据。

功能调用后：

通过将写入的字节数添加到原始值来更新。

输出	数据类型	有效范围	描述
q_sClientIP	STRING(15)	-	客户端的 IP 地址。
q_dwClientIP	DWORD	-	DWORD 格式的客户端 IP 地址；每个字节表示 IPv4 地址的一个数位。
q_uiClientPort	UINT	-	客户端的源端口。