DAQmx读取属性
- 更新时间2023-02-21
- 阅读时长11分钟
DAQmx读取属性
DAQmx读取属性可用于配置读取操作，如缓冲区中读取位置和查询读取操作的当前状态等。
| 属性 | 说明 |
|---|---|
| 相对于 | 指定内存中开始读取操作的数据点。如通过Offset指定一个偏移量，将在相对于该属性指定点的偏移量开始读取。默认值是当前读取位置，除非已为任务配置一个参考触发。如配置参考触发，默认值将是第一个触发前采样。 详细信息 |
| 偏移量 | 指定开始读取操作的偏移量（单位为每通道采样）。该偏移量相对于RelativeTo指定的位置。 详细信息 |
| 待读取通道 | 在任务中指定待读取的通道组。 详细信息 |
| 波形属性 | 指定需返回的波形数据类型属性。返回更少属性有利于提高性能。 详细信息 |
| 读取全部可用采样 | 指定后续读取操作是否读取缓冲区中可用的全部采样，或者等待缓冲区变满再读取。NI-DAQmx仅当待读取的采样值为-1时使用该设置进行有限采集。对于待读取值为-1的连续采集，读取操作总是读取当前缓冲中可用的全部采样。 详细信息 |
| 自动开始 | 如未明确通过DAQmx开始任务开始任务，将指定DAQmx读取是否自动开始任务。默认值为TRUE。当DAQmx读取开始有限采集任务时，在读取最后一个采样后也将停止任务。 详细信息 |
| 覆盖模式 | 指定是否覆盖缓冲区中尚未读取的采样。 详细信息 |
| 记录:文件路径 | 指定用于记录数据的TDMS文件的路径。如文件路径在运行任务时发生改动，该改动将在下一个采样间隔（如已设置Logging.SampsPerFile）或者调用“DAQmx开始新文件”时生效。通过结尾"\"或"/"可指定新文件路径。指定新的文件路径后所创建的文件将保持相同的名称和编号序列。 详细信息 |
| 记录:模式 | 指定是否启用记录以及在记录时是否允许读取数据。记录模式可获取最高性能。但如果指定该模式，在记录时将无法读取数据。如需在记录时读取数据，可指定“记录并读取”模式。 详细信息 |
| 记录:TDMS:组名称 | 指定在TDMS文件中创建用于本任务数据的组名。如将数据添加至现有文件并且指定组已存在，NI-DAQmx会在组名中添加一个数字符号和数字，逐步增加数字直到不存在该组名的文件。例如，如指定用户电压任务的组名并且组名已存在，NI-DAQmx将把组名指定为电压任务#1，然后为电压任务#2。 详细信息 |
| 记录:TDMS:操作 | 指定打开TDMS文件的方式。 详细信息 |
| 记录:暂停 | 指定当执行任务时是否暂停记录。如Logging.Mode被设置为记录并读取模式，将在下一次调用DAQmx读取以便将数据写入磁盘时参考该值。如Logging.Mode被设置为仅记录模式，将在下一次将数据写入磁盘时考虑该值。当从暂停状态继续记录时，将写入一个新的TDMS组。 详细信息 |
| 记录:每文件采样 | 指定每个文件写入的采样数。当文件达到指定的采样数时，将根据命名规范<文件名>_####.tdms创建一个新文件，其中####从0001开始并在每个新文件时自动增加。例如指定文件为C:\data.tdms，下一个文件名将使用C:\data_0001.tdms。如要禁用跨文件功能，可将该属性设置为0。如Logging.FilePath在设置该属性时发生改动，新文件路径将在创建下一个文件时生效。 详细信息 |
| 记录:文件写入大小 | 指定写入磁盘的数据大小（单位为采样）。该大小必须按磁盘扇区大小平均分配（单位为字节）。 详细信息 |
| 记录:文件预分配大小 | 指定磁盘中预分配空间使用的大小（单位为采样）。预分配可提高文件I/O性能，尤其当同时将多个文件写入磁盘时。对于有限任务，默认情况下将根据采集任务中配置的采样数来确定预分配文件。 详细信息 |
| 状态:当前读取位置 | 指定缓冲区中当前位置（单位为每通道采样）。 详细信息 |
| 状态:每通道可用采样 | 表示每通道可读取的采样数。对于任务中的所有通道，该值相同。 详细信息 |
| 状态:每通道采集的采样总数 | 表示每个通道采集的采样总数。由于该值对于所有通道均相同，NI-DAQmx将返回单个值。对于可重触发的采集，该值表示所有可重触发采集的采样数的累计值。 详细信息 |
| 状态:共模范围误差:共模范围误差通道存在 | 表示设备是否检测到任务中任意虚拟通道的共模范围误差。当正极或负极的接地电压超出范围时，将出现共模范围误差。读取该属性将清除任务中所有通道的违反共模范围状态。读取CommonModeRangeErrorChans之前必须读取该属性。否则将返回一个错误。 详细信息 |
| 状态:共模范围误差:共模范围误差通道 | 表示检测到共模范围误差的设备的任务中任意虚拟通道的名称列表。在读取该属性之前必须读取CommonModeRangeErrorChansExist。否则将返回一个错误。 详细信息 |
| 状态:激励故障:存在激励故障通道 | 表示设备是否检测到任务的虚拟通道中存在激励故障条件。读取该属性将清除任务中所有通道的激励故障状态。读取ExcitFaultChans之前必须读取该属性。否则将返回一个错误。 详细信息 |
| 状态:激励故障:激励故障通道 | 表示在任务中检测到激励故障条件的虚拟通道名称列表。在读取该属性之前必须读取ExcitFaultChansExist。否则将返回一个错误。 详细信息 |
| 状态:电流过载:电流过载通道存在 | 表示设备是否检测到任务中任意虚拟通道的电流过载条件。读取该属性将清除任务中所有通道的电流过载状态。在读取OvercurrentChans之前必须读取该属性。否则将返回一个错误。 详细信息 |
| 状态:电流过载:电流过载通道 | 表示检测到过流条件的设备的任务中任意虚拟通道的名称列表。在读取该属性之前必须读取OvercurrentChansExist。否则将返回一个错误。部分设备中，必须重新开始全部电流过载通道的任务以恢复。 详细信息 |
| 状态:过热:过热通道存在 | 表示设备是否检测到任务中任意虚拟通道的过热条件。读取该属性将清除任务中所有通道的过热状态。在读取OvertemperatureChans之前必须读取该属性。否则将返回一个错误。 详细信息 |
| 状态:过热:过热通道 | 表示任意过热虚拟通道的名称列表。在读取该属性之前必须读取OvertemperatureChansExist。否则将返回一个错误。 详细信息 |
| 状态:开路通道:开路通道存在 | 表示设备是否在任务虚拟通道中检测到开路通道条件。读取该属性将清除任务中所有通道的开路通道状态。读取OpenChans之前必须读取该属性。否则将返回一个错误。 详细信息 |
| 状态:开路通道:开路通道 | 显示开路虚拟通道的名称列表。读取该属性前必须先读取OpenChansExist。否则将返回一个错误。 详细信息 |
| 状态:开路通道:开路通道详细信息 | 显示开路虚拟通道的详情列表。读取该属性前必须先读取OpenChansExist。否则将返回一个错误。 详细信息 |
| 状态:电流开路:电流开路通道存在 | 表示设备是否检测到任务中任意虚拟通道的电流开路。读取该属性将清除任务中所有通道的电流开路状态。读取OpenCurrentLoopChans之前必须读取该属性。否则将返回一个错误。 详细信息 |
| 状态:电流开路:电流开路通道 | 表示检测到开环的设备的任务中任意虚拟通道的名称列表。在读取该属性之前必须读取OpenCurrentLoopChansExist。否则将返回一个错误。 详细信息 |
| 状态:开路热电偶:开路热电偶通道存在 | 表示设备是否检测到任务中任意虚拟通道连接至开路热电偶。读取该属性将清除任务中所有通道的开路热电偶状态。读取OpenThrmcplChans之前必须读取该属性。否则将返回一个错误。 详细信息 |
| 状态:开路热电偶:开路热电偶通道 | 表示检测到开路热电偶的设备的任务中任意虚拟通道的名称列表。在读取该属性之前必须读取OpenThrmcplChansExist。否则将返回一个错误。 详细信息 |
| 状态:过载:过载通道存在 | 表示设备是否检测到任务中任意虚拟通道的过载。读取该属性将清除任务中所有通道的过载状态。读取OverloadedChans之前必须读取该属性。否则将返回一个错误。 详细信息 |
| 状态:过载:过载通道 | 表示任务中任意过载虚拟通道的名称列表。在读取该属性之前必须读取OverloadedChansExist。否则将返回一个错误。 详细信息 |
| 状态:输入限制故障:输入限制故障通道存在 | 表示设备是否检测到超出任务通道上下限范围的采样。读取该属性将清除任务中所有通道的输入限制故障状态。读取InputLimitsFaultChans之前必须读取该属性。否则将返回一个错误。注：故障检测包括正输入和负输入两个范围。例如，如果指定下限为2 mA，上限为12 mA，NI-DAQmx在15 mA和-15 mA时都会报错，但是-6 mA时不会报错，因为其在-12 mA～-2 mA的范围内。 详细信息 |
| 状态:输入限制故障:输入限制故障通道 | 表示虚拟通道是否检测到超出任务通道上下限范围的采样。读取该属性前必须先读取InputLimitsFaultChansExist。否则将返回一个错误。 详细信息 |
| 状态:锁相环:存在未锁定通道 | 表示PLL当前是否锁定，或上一采集过程中是否发生解锁。设备可能在采集过程中或采集完成后报告PLL发生解除。 详细信息 |
| 状态:锁相环:未锁定通道 | 表示通道的PLL发生解锁。 详细信息 |
| 状态:电源故障:存在电源故障通道 | 表示设备是否在任务虚拟通道中检测到电源故障。读取该属性将清除任务中所有通道的电源故障状态。读取PowerSupplyFaultChans之前必须读取该属性。否则将返回一个错误。 详细信息 |
| 状态:电源故障:电源故障通道 | 表示虚拟通道检测到电源故障。读取该属性前必须先读取PowerSupplyFaultChansExist。否则将返回一个错误。 详细信息 |
| 状态:同步:存在未锁定通道 | 表示终端是否与祖父时钟锁定。设备可能在采集过程中或采集完成后报告PLL发生解除。 详细信息 |
| 状态:同步:未锁定通道 | 表示未锁定终端的设备通道。 详细信息 |
| 状态:附件:检测附件插入或移除 | 表示启动任务后，任务中的设备是否可检测插入或移除附件。读取该属性将清除任务中所有通道的附件改动状态。读取DevsWithInsertedOrRemovedAccessories之前必须读取该属性。否则将返回一个错误。 详细信息 |
| 状态:附件:带插入或移除附件的设备 | 表示启动任务后，检测到插入或移除附件的设备名称。在读取该属性之前必须读取AccessoryInsertionOrRemovalDetected。否则将返回一个错误。 详细信息 |
| 状态:远端感应错误:存在远端感应错误通道 | 指示设备是否检测到任务中任意通道的远端感应存在错误状况。必须禁用输出并解决硬件连接问题才能清除错误状况。读取“远端感应错误通道”属性之前必须先读取此属性。否则将返回一个错误。 详细信息 |
| 状态:远端感应错误:远端感应错误通道 | 指示任务中检测到远端感应连接错误状况的所有虚拟通道的名称列表。读取此属性之前必须先读取“存在远端感应错误通道”属性。否则将返回一个错误。 详细信息 |
| 状态:辅助电源错误:存在辅助电源错误通道 | 指示设备是否检测到任务中任意通道存在辅助电源错误状况。读取该属性将清除任务中所有通道的错误状态。读取“辅助电源错误通道”属性之前必须先读取此属性。否则将返回一个错误。 详细信息 |
| 状态:辅助电源错误:辅助电源错误通道 | 指示任务中检测到辅助电源错误状况的所有虚拟通道的名称列表。读取此属性之前必须先读取“存在辅助电源错误通道”属性。否则将返回一个错误。 详细信息 |
| 状态:反向电压错误:存在反向电压错误通道 | 指示设备是否检测到任务中的任何通道存在反向电压错误。如果近端电压等于负饱和电压，即会发生反向电压错误。读取此属性将清除任务中所有通道的错误状态。读取“反向电压错误通道”属性之前必须先读取此属性。否则将返回一个错误。 详细信息 |
| 状态:反向电压错误:反向电压错误通道 | 指示任务中检测到反向电压错误的所有虚拟通道的名称列表。读取此属性之前必须先读取“存在反向电压错误通道”属性。否则将返回一个错误。 详细信息 |
| 状态:高级:检测更改:溢出 | 表示是否由于检测更改事件比设备处理速度快而导致采样丢失。部分设备检测溢出方式与其它设备不同。 详细信息 |
| 高级:原始数据宽度 | 表示来自任务的原始采样的大小（单位为字节）。 详细信息 |
| 高级:通道数 | 表示DAQmx读取读取任务的通道数。该值是任务中通道数或者ChannelsToRead所指定的通道数。 详细信息 |
| 高级:数字输入:每通道的布尔值数 | 指定在基于线的读取时NI-DAQmx在采样中返回的每通道布尔数量。如果一个通道中包含的行数小于该数值额外的布尔是FALSE。 详细信息 |
| 高级:等待模式 | 指定DAQmx读取等待采样成为可用的方式。 详细信息 |
| 高级:睡眠时间 | 如WaitMode为睡眠，指定检查过可用采样后用于睡眠的时间（单位为秒）。 详细信息 |