获取波形属性函数
- 更新时间2025-07-30
- 阅读时长6分钟
获取所有属性的名称和值,如连接了名称参数,则返回该属性的值。
属性可以是通道名称。连线板将显示该多态函数的默认数据类型。

输入/输出
波形
—
波形指定要获取其属性和值的波形。
名称
—
名称是要获取值的属性的名称。 如需获取所有与指定波形关联的属性,请勿连线该参数。如连线名称,名称输出端变为布尔输出端找到,数组值输出端变为输出端值,数据类型与默认值一致。函数仅搜索指定属性。
默认值(空变体)
—
默认值是用户指定的值和数据类型。如函数未找到名称中指定的属性,可返回默认值。 如连线默认值,也必须连线名称。
错误输入(无错误)
—
错误输入表明该节点运行前发生的错误条件。该输入将提供标准错误输入功能。
波形副本
—
波形副本是波形中输入的波形数据。
名称
—
名称该一维数组包含与波形关联的所有属性的名称。 如连线名称参数,该输出端变为布尔值找到。如函数找到名称指定的属性,找到返回TRUE。
值
—
值通过变体格式返回一维数组,其中包含与指定波形的每个属性相关的值。 必须使每个属性值还原为适当的数据类型。如连线名称,该输出端可变为单个变体值。如函数未找到名称中指定的属性,可返回传递至默认值的值。
错误输出
—
错误输出包含错误信息。该输出提供标准错误输出功能。 |
依据是否连接名称参数,该函数有两种模式。默认状态下,函数返回所有属性的名称及相应以一维数组表示的值。如连线名称输入端,名称输出端可变为布尔输出端找到,值输出端可变为变体输出端值,该函数仅搜索指定的属性。如函数没有找到指定的属性,或函数不能使属性转换为默认值,则找到为FALSE,值显示的是默认值的内容。
下表是NI-DAQ设置的波形属性。
| 名称 | 属性 | 数据类型 | 可接收的值 | 说明 |
|---|---|---|---|---|
| 硬件设备编号 | NI_DeviceNumber | 字符串 | NI_DeviceNumber可以是任何值。 | NI_DeviceNumber是产生波形的硬件设备的编号。 |
| 通道名称 | NI_ChannelName | 字符串 | NI_ChannelName可以是任何值。 | NI_ChannelName是产生信号的虚拟通道的名称。 |
| 数字线名称 | NI_LineNames | 字符串 | NI_LineName可以是任何值。 | NI_LineName是波形中数字线的名称。 |
| 数据单位 | NI_UnitDescription | 字符串 | NI_UnitDescription可接受Volts、PSI等值。 | NI_UnitDescription是波形的测量单位。 |
下表是Express VI设置的波形属性。
| 名称 | 属性 | 数据类型 | 可接收的值 | 说明 |
|---|---|---|---|---|
| 起始时间标识 | NI_ExpStartTimeStamp | 时间标识 | NI_ExpStartTimeStamp可以是任何值。 | NI_ExpStartTimeStamp是第一个波形中第一个采样的时间标识。在Express VI中,即使波形数据是在循环中产生的,VI每次启动时均会重新设置时间标识。在Express VI中,除非波形在NI-DAQ中生成,否则依据电脑的时钟设置NI_ExpStartTimeStamp。波形在NI-DAQ中产生时,由NI-DAQ设置NI_ExpStartTimeStamp。 |
| 时间标识 | NI_ExpTimeStamp | 时间标识 | NI_ExpTimeStamp可以是任何值。 | NI_ExpTimeStamp是波形中第一个采样的时间标识。在Express VI中,除非波形在NI-DAQ中生成,否则依据电脑的时钟设置NI_ExpTimeStamp。波形在NI-DAQ中产生时,由NI-DAQ设置NI_ExpTimeStamp。 |
| X维数 | NI_ExpXDimension | 字符串 | NI_ExpXDimension的值为单个字符。当前仅支持t表示时间,f表示频率。NI_ExpXDimension的值区分大小写。 | 如NI_ExpXDimension的值为t,t0和dt不变。NI_ExpXDimension的值为f,Express VI认为t0和dt分别是f0和df。对于所有其他值或未知维数,Express VI视t0和dt为X0和dX,但参数值无效。 |
| 相对时间? | NI_ExpIsRelativeTime | 布尔 | NI_ExpIsRelativeTime的值为TRUE或FALSE。 | 当且仅当NI_ExpXDimension为t时,Express VI才设置绝对/相对时间标识的值为t0。 |
注: Express VI也使用NI-DAQ设置的属性。如波形不是在NI-DAQmx中产生的,Express VI可添加NI_ChannelName。
波形
—
名称
—
默认值(空变体)
—
错误输入(无错误)
—
波形副本
—
名称
—
值
—
错误输出
—