複数レコードの読み取り (2D U8)
- 更新日2023-02-17
- 5分で読める
複数レコードの読み取り (2D U8)
集録した波形を符号なし8ビット整数の2次元配列として返します。
入力/出力
セッション入力
「集録セッションを初期化」ノード、「生成セッションを初期化ノード」、または「外部キャリブレーションを初期化」ノードにより取得された計測器セッションです。
読み取るサンプル数
フェッチするサンプル数を指定します。
デバイスメモリ内のサンプル数より大きい値を読み取るサンプル数で指定した場合、NI-HSDIOは最大時間 (ミリ秒)が経過した後に集録されたサンプルを返します。このパラメータを-1に設定すると、「niHSDIO集録サイズを構成」ノードで指定したサンプル数/レコードが集録されます。
最大時間 (ms)
NI-HSDIOがタイムアウトエラーを返す前に、ノードの処理を行うための最大時間 (ミリ秒) です。
-1に設定した場合、ノードはタイムアウトエラーになりません。このパラメータを0に設定すると、ノードは最大で読み取るサンプル数で指定する数のサンプルを即座に返します。
読み取るサンプル数がデバイスメモリ内のサンプル数より多く、すべての有効サンプルがタイムアウト前に集録された場合、NI-HSDIOは有効なサンプルを返します。
Default value: 10000
開始レコード
データのフェッチを開始するレコードです。
Default value: 0
フェッチするレコード数
オンボードメモリからフェッチするレコードの数です。
Default value: -1
エラー入力
セッション出力
以降のすべてのノード呼び出しにおいて、セッションを認識するために使用するハンドルです。
セッション出力パラメータは、「集録セッションを初期化」ノードまたは「生成セッションを初期化」ノードから取得できます。
データ
波形データが返されます。
波形情報
操作の絶対タイムスタンプと相対タイムスタンプ、dt、および実際に読み取られたサンプル数です。
絶対タイムスタンプ
絶対タイムスタンプには、操作の絶対タイムスタンプが返されます。
相対タイムスタンプ
相対タイムスタンプには、操作の相対タイムスタンプが返されます。
dt
dtには、波形の2つの値の差分時間が返されます。
実際に読み取られたサンプル数
読み取られたサンプル数が返されます。
予約済み1
予約済み1は、将来用に予約されています。
予約済み2
予約済み2は、将来用に予約されています。
