从指定的.tdms文件中异步读取数据，并将数据保存在LabVIEW之外的存储器中。该函数的数据引用输入指定外部存储器的位置，例如，设备驱动拥有的DMA缓冲区。


icon

输入/输出

  • cgnrn.png tdms文件 —

    tdms 文件 指定了执行操作的 .tdms 文件的 参考号 。高级TDMS打开函数用于打开引用句柄。

  • cdatavalref.png 数据引用 —

    data reference 指定 外部数据值引用 ，该 引用 指向外部缓冲区的区域，LabVIEW 希望将该函数从 .tdms 文件读取的数据存储在该区域中。该输入接受包含一维或二维整数数组、浮点数数组、布尔值数组和时间标识数组的外部数值引用。如高级TDMS打开函数的禁用缓冲？输入为TRUE，连线至数据引用输入的数据大小必须为扇区大小的整数倍。

  • cerrcodeclst.png 错误输入（无错误） —

    错误输入表明该节点运行前发生的错误条件。该输入将提供标准错误输入功能。

  • cbool.png 自动删除引用？(T) —

    自动删除引用？指定在异步操作结束后，LabVIEW是否自动删除数据引用。删除数据引用即告诉外部存储所有者LabVIEW不再需要访问外部存储空间。默认值为TRUE。该值为FALSE时表示在异步操作结束后还要继续使用引用。例如，删除引用之前，可能要在LabVIEW中修改数据。该值为FALSE时，必须使用删除数值引用函数删除数值引用。

  • ignrn.png tdms文件输出 —

    tdms file out 返回一个 TDMS 文件 引用 ，指向您执行操作的 .tdms 文件。

  • ierrcodeclst.png 错误输出 —

    错误输出包含错误信息。该输出提供标准错误输出功能。

  • ibool.png 读进程已完成？ —

    读进程已完成？表明读进程是否结束。

    提示 布尔值可作为While循环的停止条件之一。例如，在While循环中放置“高级TDMS异步读取（数据引用）”函数可连续读取数据，直至读进程已完成？的值返回TRUE。满足下列条件时，该值返回TRUE：
    • “高级TDMS异步读取（数据引用）”函数到达.tdms文件末尾。
    • “TDMS高级异步读取（数据引用）”函数已读取为TDMS高级异步读取（数据引用）函数的总计数指定的数据。

    • 该函数可以在后台执行异步读取的同时发出更多异步读取指令。当后台的异步读取数量达到最大值，该函数将等待异步读取操作完成一次然后再发出一个异步读取指令。如在超时发生之前异步读取没有完成，函数将返回错误代码–2546。TDMS配置异步读取（数据引用）函数用于配置最大异步读取数量和超时值。

    使用TDMS获取异步读取状态（数据引用）函数可查询挂起的异步读取操作的数量。