ReadUserDataBuffer

Esta función se utiliza para leer los datos contenidos en el campo User Data del protocolo de comunicación industrial que se tiene habilitado. La estructura de datos Buffer referenciada, que ha sido creada por una función FormatInputBuffer, define cómo han de interpretarse los datos recibidos.

ReadUserDataBuffer Entradas

Parámetro Descripción
Evento

Especifica el evento de actualización que ocasiona la lectura de datos.

Este parámetro debe ser una referencia para cualquier evento con una marca de fecha y hora, por ejemplo, uno de los siguientes: 

  • Una celda que contiene una función Event.
  • Una celda que contiene una función Button.
Buffer Especifica una referencia a una estructura de datos Buffer que ha sido creada por una función FormatInputBuffer y que define cómo han de interpretarse los datos recibidos.
Protocolo

Especifica el protocolo a utilizar para leer los datos de usuario.

1 = EtherNet/IP Especifica que EtherNet/IP es el protocolo de comunicación industrial que está activado.
2 = PROFINET Especifica que PROFINET es el protocolo de comunicación industrial que está activado.
100 = Por defecto Especifica que se utilizará el protocolo de comunicación industrial que está actualmente activado. Si hay más de un protocolo activado, se utilizará el protocolo que se ha habilitado primero.
Validar conexión Especifica si la función intentará o no validar la conexión. Si está habilitada, la función devolverá #ERR si el protocolo seleccionado no tiene una conexión cíclica activa.
Orden de bytes/palabras

Especifica el orden de los bits para palabras y los bytes leídos por la función.

0 = Big endian Especifica que se almacena primero el byte más significativo y que los siguientes bytes se almacenan en orden descendente.
1 = Little endian Especifica que se almacena primero el byte menos significativo y que los siguientes bytes se almacenan en orden ascendente.
2 = Big endian con permuta de palabras de 16 bits Se aplicará el estilo de bytes Big Endian y los tipos de palabra doble tendrán los pares de palabras en orden invertido. (Palabras de 16 bits)
3 = Little endian con permuta de palabras de 16 bits Se aplicará el estilo de bytes Little Endian y los tipos de palabra doble tendrán los pares de palabras en orden invertido. (Palabras de 16 bits)
100 = Por defecto Se utiliza el ajuste por defecto.

ReadUserDataBuffer Salidas

Devuelve

Una estructura de datos UserData que contiene los datos enviados por un cliente o #ERR:

  • si alguno de los parámetro de entrada no es válido
  • si no se ha establecido una conexión con un cliente

  • si no se han escrito datos en el búfer desde que se estableció la conexión
Resultados Se accede a los datos de la estructura de DatosDeUsuario mediante la función GetBufferData. Para más información, consulte el tema Entrada/Salida.