niHWS Read
A read moves the read/write position so that it points to the next unread sample in the waveform. The instances of this polymorphic VI allow you to read in analog or digital waveform samples and return them as a specified data type.
Use the pull-down menu to select an instance of this VI.
Read Analog WDT
Returns analog waveform samples beginning at the current read/write position.
Analog waveform data stored as DBL returns unaltered.
Analog waveform data stored as integers (I8, I16, or I32) is scaled to DBL using the stored scaling coefficients.
 |
waveform reference in is a reference to the waveform. Waveforms are identified by reference for purposes of setting and getting waveform attributes and reading and writing data. | ||||||
 |
number of samples to read specifies how many samples to read into the data array.
The default value for number of samples to read is -1, which specifies that the entire waveform is read. If number of samples to read is 0, the number of samples in the waveform is returned in the actual samples read parameter. |
||||||
 |
error in (no error) 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.
| ||||||
 |
waveform reference out is the copy of waveform reference in you use for input into the next NI-HWS VI in your program. | ||||||
 |
actual samples read reports the number of samples read.
If number of samples to read is 0, the number of samples in the waveform is returned in the actual samples read parameter. |
||||||
 |
analog waveform contains the data for the waveform. | ||||||
 |
error out 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.
|
Read Analog DBL
Returns analog waveform samples as double-precision floating-point data (DBL) beginning at the current read/write position.
Analog waveform data stored as DBL returns unaltered.
Analog waveform data stored as integers (I8, I16, or I32) is scaled to DBL using the stored scaling coefficients.
|
waveform reference in is a reference to the waveform. Waveforms are identified by reference for purposes of setting and getting waveform attributes and reading and writing data. | ||||||
|
number of samples to read specifies how many samples to read into the data array.
The default value for number of samples to read is -1, which specifies that the entire waveform is read. If number of samples to read is 0, the number of samples in the waveform is returned in the actual samples read parameter. |
||||||
|
error in (no error) 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.
| ||||||
|
waveform reference out is the copy of waveform reference in you use for input into the next NI-HWS VI in your program. | ||||||
|
actual samples read reports the number of samples read.
If number of samples to read is 0, the number of samples in the waveform is returned in the actual samples read parameter. |
||||||
 |
data contains the data for the waveform. | ||||||
|
error out 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.
|
Read Analog I8
Returns analog waveform samples as 8-bit signed integers (I8) beginning at the current read/write position. Only I8 data can be read with this VI.
|
waveform reference in is a reference to the waveform. Waveforms are identified by reference for purposes of setting and getting waveform attributes and reading and writing data. | ||||||
|
number of samples to read specifies how many samples to read into the data array.
The default value for number of samples to read is -1, which specifies that the entire waveform is read. If number of samples to read is 0, the number of samples in the waveform is returned in the actual samples read parameter. |
||||||
|
error in (no error) 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.
| ||||||
|
waveform reference out is the copy of waveform reference in you use for input into the next NI-HWS VI in your program. | ||||||
|
actual samples read reports the number of samples read.
If number of samples to read is 0, the number of samples in the waveform is returned in the actual samples read parameter. |
||||||
 |
data contains the data for the waveform. | ||||||
|
error out 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.
|
Read Analog I16
Returns analog waveform samples as 16-bit signed integers (I16) beginning at the current read/write position. Only I8 or I16 data can be read with this VI. I8 data is sign-extended to 16 bits when read with this VI.
|
waveform reference in is a reference to the waveform. Waveforms are identified by reference for purposes of setting and getting waveform attributes and reading and writing data. | ||||||
|
number of samples to read specifies how many samples to read into the data array.
The default value for number of samples to read is -1, which specifies that the entire waveform is read. If number of samples to read is 0, the number of samples in the waveform is returned in the actual samples read parameter. |
||||||
|
error in (no error) 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.
| ||||||
|
waveform reference out is the copy of waveform reference in you use for input into the next NI-HWS VI in your program. | ||||||
|
actual samples read reports the number of samples read.
If number of samples to read is 0, the number of samples in the waveform is returned in the actual samples read parameter. |
||||||
 |
data contains the data for the waveform. | ||||||
|
error out 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.
|
Read Analog I32
Returns analog waveform samples as 32-bit signed integers (I32) beginning at the current read/write position. I8 or I16 data is sign-extended to 32 bits when read with this VI.
|
waveform reference in is a reference to the waveform. Waveforms are identified by reference for purposes of setting and getting waveform attributes and reading and writing data. | ||||||
|
number of samples to read specifies how many samples to read into the data array.
The default value for number of samples to read is -1, which specifies that the entire waveform is read. If number of samples to read is 0, the number of samples in the waveform is returned in the actual samples read parameter. |
||||||
|
error in (no error) 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.
| ||||||
|
waveform reference out is the copy of waveform reference in you use for input into the next NI-HWS VI in your program. | ||||||
|
actual samples read reports the number of samples read.
If number of samples to read is 0, the number of samples in the waveform is returned in the actual samples read parameter. |
||||||
 |
data contains the data for the waveform. | ||||||
|
error out 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.
|
Read Digital WDT
Returns digital waveform samples in the digital waveform data type format, beginning at the current read/write position.
|
waveform reference in is a reference to the waveform. Waveforms are identified by reference for purposes of setting and getting waveform attributes and reading and writing data. | ||||||
|
number of samples to read specifies how many samples to read into the data array.
The default value for number of samples to read is -1, which specifies that the entire waveform is read. If number of samples to read is 0, the number of samples in the waveform is returned in the actual samples read parameter. |
||||||
|
error in (no error) 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.
| ||||||
|
waveform reference out is the copy of waveform reference in you use for input into the next NI-HWS VI in your program. | ||||||
|
actual samples read reports the number of samples read.
If number of samples to read is 0, the number of samples in the waveform is returned in the actual samples read parameter. |
||||||
 |
digital waveform contains the data for the waveform. | ||||||
|
error out 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.
|
Read Digital 1D U8
Returns digital waveform samples as an array of 8-bit unsigned integers (U8) beginning at the current read/write position.
|
waveform reference in is a reference to the waveform. Waveforms are identified by reference for purposes of setting and getting waveform attributes and reading and writing data. | ||||||
|
number of samples to read specifies how many samples to read into the data array.
The default value for number of samples to read is -1, which specifies that the entire waveform is read. If number of samples to read is 0, the number of samples in the waveform is returned in the actual samples read parameter. |
||||||
|
error in (no error) 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.
| ||||||
|
waveform reference out is the copy of waveform reference in you use for input into the next NI-HWS VI in your program. | ||||||
|
actual samples read reports the number of samples read.
If number of samples to read is 0, the number of samples in the waveform is returned in the actual samples read parameter. |
||||||
 |
data contains the data for the waveform. | ||||||
|
error out 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.
|
Read Digital 2D U8
Returns digital waveform samples as a two-dimensional array of 8-bit unsigned integers (U8) beginning at the current read/write position.
|
waveform reference in is a reference to the waveform. Waveforms are identified by reference for purposes of setting and getting waveform attributes and reading and writing data. | ||||||
|
number of samples to read per row specifies how many samples to read into the data array.
The default value for number of samples to read per row is -1, which specifies that the entire waveform is read. If number of samples to read per row is 0, the number of samples in the waveform is returned in the actual samples read parameter. |
||||||
|
error in (no error) 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.
| ||||||
|
waveform reference out is the copy of waveform reference in you use for input into the next NI-HWS VI in your program. | ||||||
|
actual samples read per row reports the number of samples read.
If number of samples to read per row is 0, the number of samples in the waveform is returned in the actual samples read per row parameter. |
||||||
 |
data contains the data for the waveform. | ||||||
|
error out 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.
|
Read Digital 1D U16
Returns digital waveform samples as an array of 16-bit unsigned integers (U16) beginning at the current read/write position.
|
waveform reference in is a reference to the waveform. Waveforms are identified by reference for purposes of setting and getting waveform attributes and reading and writing data. | ||||||
|
number of samples to read specifies how many samples to read into the data array.
The default value for number of samples to read is -1, which specifies that the entire waveform is read. If number of samples to read is 0, the number of samples in the waveform is returned in the actual samples read parameter. |
||||||
|
error in (no error) 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.
| ||||||
|
waveform reference out is the copy of waveform reference in you use for input into the next NI-HWS VI in your program. | ||||||
|
actual samples read reports the number of samples read.
If number of samples to read is 0, the number of samples in the waveform is returned in the actual samples read parameter. |
||||||
 |
data contains the data for the waveform. | ||||||
|
error out 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.
|
Read Digital 2D U16
Returns digital waveform samples as a two-dimensional array of 16-bit unsigned integers (U16) beginning at the current read/write position.
|
waveform reference in is a reference to the waveform. Waveforms are identified by reference for purposes of setting and getting waveform attributes and reading and writing data. | ||||||
|
number of samples to read per row specifies how many samples to read into the
data array.
The default value for number of samples to read per row is -1, which specifies that the entire waveform is read. If number of samples to read per row is 0, the number of samples in the waveform is returned in the actual samples read per row parameter. |
||||||
|
error in (no error) 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.
| ||||||
|
waveform reference out is the copy of waveform reference in you use for input into the next NI-HWS VI in your program. | ||||||
|
actual samples read per row reports the number of samples read.
If number of samples to read is 0, the number of samples in the waveform is returned in the actual samples read parameter. |
||||||
 |
data contains the data for the waveform. | ||||||
|
error out 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.
|
Read Digital 1D U32
Returns digital waveform samples as an array of 32-bit unsigned integers (U32) beginning at the current read/write position.
|
waveform reference in is a reference to the waveform. Waveforms are identified by reference for purposes of setting and getting waveform attributes and reading and writing data. | ||||||
|
number of samples to read specifies how many samples to read into the data array. The default value for number of samples to read is -1, which specifies that the entire waveform is read. If number of samples to read is 0, the number of samples in the waveform is returned in the actual samples read parameter. | ||||||
|
error in (no error) 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.
| ||||||
|
waveform reference out is the copy of waveform reference in you use for input into the next NI-HWS VI in your program. | ||||||
|
actual samples read reports the number of samples read.
If number of samples to read is 0, the number of samples in the waveform is returned in the actual samples read parameter. |
||||||
 |
data contains the data for the waveform. | ||||||
|
error out 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.
|
Read Digital 2D U32
Returns digital waveform samples as a two-dimensional array of 32-bit integers (U32) beginning at the current read/write position.
|
waveform reference in is a reference to the waveform. Waveforms are identified by reference for purposes of setting and getting waveform attributes and reading and writing data. | ||||||
|
number of samples to read per row specifies how many samples to read into the data array. The default value for number of samples to read per row is -1, which specifies that the entire waveform is read. If number of samples to read per row is 0, the number of samples in the waveform is returned in the actual samples read per row parameter. | ||||||
|
error in (no error) 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.
| ||||||
|
waveform reference out is the copy of waveform reference in you use for input into the next NI-HWS VI in your program. | ||||||
|
actual samples read per row reports the number of samples read. | ||||||
 |
data contains the data for the waveform. | ||||||
|
error out 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.
|