Reads the specified .tdms file and returns data in a format specified by the data type input. This function returns data that was previously read into the buffers configured in the TDMS Configure Asynchronous Reads function. This function can execute multiple asynchronous reads simultaneously in the background.


icon

Inputs/Outputs

  • cgnrn.png tdms file —

    tdms file specifies a reference number to the .tdms file on which to perform the operation. Use the TDMS Advanced Open function to open the refnum.

  • cerrcodeclst.png error in (no error) —

    error in describes error conditions that occur before this node runs. This input provides standard error in functionality.

  • cu8.png data type —

    data type specifies the type of data on which you want to perform the operation. This input accepts integers, floating-point numbers, Booleans, and timestamps.

    Note You can wire the following floating-point numbers to this input:
    • Single-precision and double-precision floating-point numbers
    • Complex single-precision and double-precision floating-point numbers
    • Extended-precision floating-point numbers
  • ignrn.png tdms file out —

    tdms file out returns a TDMS file reference to the .tdms file on which you performed the operation.

  • i1du8.png data —

    data returns the data this function reads from the .tdms file in the specified data type.

  • ierrcodeclst.png error out —

    error out contains error information. This output provides standard error out functionality.

  • ibool.png read process finished? —

    read process finished? indicates whether the reading process is finished or not.

    Tip

    Use this Boolean value as one of the stop conditions for a While Loop. For example, you can place the TDMS Advanced Asynchronous Read function in the While Loop to read data indefinitely until the value of read process finished? returns TRUE. This value returns TRUE when one of the following conditions occurs:

    • The TDMS Advanced Asynchronous Read function reaches the end of a .tdms file.
    • The TDMS Advanced Asynchronous Read function finishes reading total count of data that you specify for the TDMS Start Asynchronous Reads function.

    • Examples

    Refer to the following example files included with LabVIEW.

    • labview\examples\File IO\TDMS\Advanced Read and Write\Asynchronous Read and Write\TDMS Advanced Basic Asynchronous Read.vi
    • labview\examples\File IO\TDMS\Advanced Read and Write\Asynchronous Read and Write\TDMS Advanced Finite Asynchronous Read.vi
    • labview\examples\File IO\TDMS\Advanced Read and Write\Asynchronous Read and Write\TDMS Advanced Prefetched Asynchronous Read.vi