中断付き読み取り
- 更新日2025-07-30
- 6分で読める
ストリームチャンネルから要素を読み取るか、チャンネルを中断させます。このエンドポイントは、中断入力と中断された?出力が付いている以外は読み取りエンドポイントと同じです。ストリームチャンネルの中断機能を使用すると、チャンネルバッファに残っているデータを無視して、即時にチャンネルを閉じることができます。このエンドポイントは、中断付き書き込みエンドポイントと併せて使用する必要があります。

入力/出力
タイムアウト入力 (ms) (-1)
—
タイムアウト入力 (ms) は、このエンドポイントがチャンネルから要素を読み取る時間 (ミリ秒) です。デフォルト値は-1のため、時間制限はありません。
チャンネル
—
チャンネルは、このエンドポイントを書き込みエンドポイントに接続するチャンネルワイヤです。
中断
—
中断は、このチャンネルを中断するかどうかを指定します。中断がTRUEの場合、このエンドポイントはチャンネルを終了とマークし、それ以降の読み取り呼び出しを無視します。一方、中断された?は、このエンドポイントの次の呼び出しでTRUEを返します。
タイムアウト?
—
タイムアウト?は、エンドポイントが要素に指定されたデータをチャンネル~読み取る前にタイムアウト (ms) に指定された時間が経過した場合にTRUEを返します。この出力は、中断された?がTRUEの場合はFALSEを返します。タイムアウト?がTRUEの場合、要素が有効?と最後の要素?はFALSEになります。
要素が有効?
—
要素が有効?は、要素が正常に読み取られるとTRUEを返します。この出力は、タイムアウトが発生した場合、チャンネルが有効な最後の要素を受信せずに閉じた場合、またはチャンネルが中断した場合にFALSEを返します。
要素
—
要素は、このエンドポイントがチャンネルから読み取るデータを返します。この出力は、タイムアウトが発生したか、チャンネルが有効な最後の要素を受信せずに閉じたか、チャンネルが中断した場合、転送データタイプのデフォルトの値を返します。
最後の要素?
—
最後の要素?は、これがエンドポイントがチャンネルから読み取る最後の要素かどうかを返します。最後の要素?は、要素が有効?がFALSEであってもTRUEになることがあります。この場合、最後の要素が前回の反復でチャンネルにすでに書き込まれていたか、チャンネルが有効な最後の要素を受信せずに閉じたことを意味します。この出力は、タイムアウトが発生するか、チャンネルが中断するとFALSEを返します。
中断された?
—
中断された?は、このエンドポイントまたはチャンネルに接続されている書き込みエンドポイントで中断が発生した場合にTRUEを返します。中断された?がTRUEの場合、それ以降のこのエンドポイントの呼び出しは、再度中断された?がTRUEを返す以外はなにもしません。
カウント
—
カウントは、このエンドポイントがチャンネルを更新した後、チャンネルの要素数を返します。この出力は、チャンネルエンドポイントの書き込みおよび読み取りの相対速度を監視し、必要に応じて調整するために使用します。 |
FPGAモジュールの詳細
以下の説明は、このオブジェクトをFPGA VIで使用する場合に適用されます。
| シングルサイクルタイミングループ | サポートされていません。 |
| Usage | 配列では、このエンドポイントはサポートされているデータタイプの固定サイズ1D配列のみをサポートしています。このエンドポイントは、配列がコンパイル時に固定サイズに決定される場合でも可変サイズの配列をサポートしません。 このエンドポイントはLabVIEWクラスをサポートしていません。 このエンドポイントを単精度浮動小数点データタイプで使用する場合、リソース使用、レイテンシ、およびシングルサイクルタイミングループのサポートの影響については、以下のトピックを参照してください。 |
| リソース | このエンドポイントは、チャンネルインスタンスで一緒に使用される書き込みエンドポイントとリソースを共有します。書き込みエンドポイントは、サイズで指定された数に比例するFPGAリソースを必要とします。 |
| メモ | 非再入可能サブVIのチャンネル端子は、1つのチャンネルのみに接続できます。非再入可能サブVIが複数の箇所から呼び出された場合、指定された端子に接続されたチャンネルワイヤは、コンパイル時に同じチャンネルに決定される必要があります。 |
タイムアウト入力 (ms) (-1)
—
チャンネル
—
中断
—
タイムアウト?
—
要素
—
カウント
—