ReadUserDataBuffer

该函数用于读取当前启用的工厂通信协议的 User Data 字段中包含的数据。由 FormatInputBuffer 函数创建的引用的 Buffer 数据结构定义了如何解释接收到的数据。

ReadUserDataBuffer 输入

参数 说明
事件

指定要读取数据的更新事件。

此参数需要是对具有时间戳的任何事件的引用，例如以下之一： 

  • 包含事件函数的单元格。
  • 包含按钮函数的单元格。
缓冲区 指定对由 FormatInputBuffer 函数创建的 Buffer 数据结构的引用，该函数定义如何解释接收到的数据。
协议

指定应从哪个协议读取用户数据。

1 = 以太网/IP 指定以太网/IP 是启用的工厂通信协议。
2 = PROFINET 指定 PROFINET 是启用的工厂通信协议。
100 = 默认值 指定将使用当前启用的工厂通信协议。如果启用了多个协议，将使用第一个启用的协议。
验证连接 指定该函数是否将尝试验证连接。如果启用，如果所选协议没有活动的循环连接，该函数将返回#ERR。
Byte/Word Order

指定函数读取的字和字节的位顺序。

0 = big endian 指定先存储最高有效字节，然后按降序存储后续字节。
1 = little endian 指定先存储最低有效字节，然后按升序存储后续字节。
2 = 具有 16 位字交换的 Big Endian 将应用 big endian 字节样式，双字类型将切换其字对顺序。（16 位字）
3 = 具有 16 位字交换的 Little Endian 将应用 little endian 字节样式，双字类型将切换其字对顺序。（16 位字）
100 = 默认值 使用默认设置。

ReadUserDataBuffer 输出

返回

包含客户端发送的数据的 UserData 数据结构；或#ERR：

  • 如果任何输入参数无效
  • 如果尚未建立来自客户端的连接

  • 如果自建立连接以来尚未写入数据缓冲区
结果 使用 GetBufferData 函数访问 UserData 数据结构中的数据。有关详细信息，请参阅输入/输出主题。