上級TDMS非同期読み取り (データリファレンス)関数
- 更新日2025-07-30
- 5分で読める
指定された.tdmsファイルからデータを非同期で読み取り、LabVIEW外部のコンポーネントのメモリにデータを保存します。この関数のデータリファレンス入力で、外部メモリ (デバイスドライバのDMAバッファの特定の領域など) の場所を指定できます。

入力/出力
TDMSファイル
—
データリファレンス
—
エラー入力 (エラーなし)
—
エラー入力は、このノードを実行する前に発生したエラーの状態を示します。この入力は、標準エラー入力として機能します。
リファレンスを自動削除? (T)
—
リファレンスを自動削除?は、非同期操作の完了時にデータリファレンスを自動的に削除するかどうかを指定します。データリファレンスを削除することで、外部メモリの所有者にLabVIEWからその外部メモリへのアクセスが不要になったことを通知できます。デフォルトはTRUEです。非同期操作の完了後もリファレンスを使用する場合は、この値をFALSEにします。たとえば、リファレンスを削除する前にLabVIEWでデータを修正する場合がこれにあたります。この値をFALSEに設定する場合は、「データ値リファレンスを削除」関数でデータリファレンスを削除する必要があります。
TDMSファイル出力
—
エラー出力
—
エラー出力には、エラー情報が含まれます。この出力は、標準エラー出力として機能します。
読み取り処理終了?
—
読み取り処理終了?は、読み取り処理が終了したかどうかを示します。 ヒント Whileループの停止条件の1つとしてこのブール値を使用します。たとえば、Whileループに「上級TDMS非同期読み取り (データリファレンス)」関数を配置して、読み取り処理終了?がTRUEを返すまで無期限にデータを読み取ることができます。この値は、以下のいずれかの状態が発生したときにTRUEになります。
|
この関数では、すでに発行された非同期読み取りのバックグラウンドでの実行中に、非同期読み取りを追加できます。この関数は、バックグラウンドでの非同期読み取りの数が最大値に達した場合は、すでに発行された非同期読み取りが完了してから非同期読み取りを追加します。すでに発行された非同期読み取りがタイムアウト時間内に完了しないと、エラーコード–2546を返します。非同期読み取りの最大数とタイムアウト値は、「TDMS非同期読み取りを構成 (データリファレンス)」関数で構成します。
保留状態の非同期読み取りの数をクエリするには、「TDMS非同期読み取りステータスを取得 (データリファレンス)」関数を使用します。
TDMSファイル
—
データリファレンス
—
エラー入力 (エラーなし)
—
リファレンスを自動削除? (T)
—
TDMSファイル出力
—
エラー出力
—
読み取り処理終了?
—