FIFO.采集写入区域(调用方法)
- 更新时间2025-01-28
- 阅读时长2分钟
请求一个区域写入目标设备驱动程序中的主机内存缓冲区,并返回一个该区域的 外部数据值引用 。如调用该方法前未调用“开始”方法,该方法将自动开启DMA通道。
注: 仅当已在FIFO 类型 为 主机至终端—DMA的 通用FIFO属性 页。
参考关于使用该方法的详细信息,请参阅《 提高访问DMA FIFO时的效率》。
使用调用方法 函数来实现该方法。
| 选项 | 说明 |
|---|---|
| FPGA VI引用输入 | FPGA VI引用输入表示FPGA VI的引用。您必须打开FPGA VI引用 以使用该参数。 |
| 错误输入 | 错误输入表明该节点运行前发生的错误条件。该输入将提供标准错误输入功能。 |
| 元素个数 | 元素数量指定被采集的缓冲区大小(以元素为单位)。
注: NI建议 元素 数为主机FIFO大小的整除数。使用FIFO.配置方法。例如,主FIFO的大小为32,768个元素,元素数量为8,192,调用采集写入区域方法四次可填满FIFO缓冲区。在本范例中,对采集写入区域方法的顺序调用在FIFO的起始处启动。但如元素数量不是主FIFO大小的整数约数,LabVIEW在FIFO末端写入部分区域数据。此时,区域元素数量返回该区域中实际数量的元素。
|
| 超时(ms) | 超时(ms)指定调用方法函数超时前等待的最短时间,以毫秒为单位。在下列情况下调用方法函数超时:如区域可访问但请求的空元素数量不可用,或部分区域不可访问。默认值为5000毫秒。如希望调用方法函数无限等待,可将参数设置为–1。 |
| FPGA VI引用输出 | FPGA VI引用输出将返回FPGA VI的引用。 |
| 错误输出 | 错误输出包含错误信息。该输出提供标准错误输出功能。 |
| 写入区域引用 | 写入区域引用是设备驱动程序分配的元素数组的引用。您必须在驱动程序从缓冲区的指定部分读取新数据之前, 删除 该外部数据值引用。 |
| 区域中的元素 | 区域元素数量返回采集的内存区域的全部元素数量。 |
| 剩余空元素 | 剩余空元素返回主机内存缓冲区中可写入的元素数量。 |