XNET Read (Signal Waveform) VI
- Updated2025-10-07
- 3 minute(s) read
Reads data from a session of Signal Input Waveform mode. The data represents a waveform of resampled values for each signal in the session. You can wire the data directly to a LabVIEW Waveform Graph for display.

Inputs/Outputs
session in
—
session in is the session to read. This session is selected from the LabVIEW project or returned from the XNET Create Session VI. The session mode must be Signal Input Waveform.
number to read (-1)
—
number to read is the number of samples desired. If number to read is positive (or 0), the number of samples returned (size of Y arrays) is no greater than this number. If timeout is nonzero, the number returned is exactly this number on success. If number to read is negative (typically –1), the maximum number of samples is returned. If number to read is negative, you must use a timeout of zero. This input is optional. The default value is –1.
timeout (0)
—
timeout is the time to wait for number to read samples to become available. The timeout is a LabVIEW relative time, represented as 64-bit floating-point in units of seconds. If timeout is positive, the XNET Read (Signal Waveform) VI waits for number to read samples, then returns that number. If the samples do not arrive prior to the timeout, an error is returned. If timeout is negative, the XNET Read (Signal Waveform) VI waits indefinitely for number to read samples. If timeout is zero, the XNET Read (Signal Waveform) VI does not wait and immediately returns all available samples up to the limit number to read specifies. Because time determines sample availability, typical values for this timeout are 0 (return available) or a large positive value such as 100.0 (wait for a specific number to read). This input is optional. The default value is 0.0.
error in (no error)
—
The error in cluster can accept error information wired from VIs previously called. Use this information to decide if any functionality should be bypassed in the event of errors from other VIs. The pop-up option Explain Error (or Explain Warning) gives more information about the error displayed.
session out
—
session out is the same as session in, provided for use with subsequent VIs.
data
—
data returns a one-dimensional array of LabVIEW waveforms. Each array element corresponds to a signal configured for the session. The order of signals in the array corresponds to the order in the session list. The waveform elements are:
error out
—
The error out cluster passes error or warning information out of a VI to be used by other VIs. The pop-up option Explain Error (or Explain Warning) gives more information about the error displayed. |
session in
—
number to read (-1)
—
timeout (0)
—
error in (no error)
—
session out
—
data
—
error out
—