次の使用可能なデータ値を接続入力で指定された接続に関連付けられたクライアント側のバッファのキューから削除し、そのデータを返します。

メモ また、クライアント側のバッファ処理は、opcおよびfileなどの他のプロトコルにも適用されます。ただし、場合によっては、これらのサーバでデータが失われる可能性もあります。


icon

入力/出力

  • cstr.png 接続入力

    接続入力は、読み取るデータソースを識別します。

    connection inにはurlを表す文字列、 共有変数コントロールDataSocket Open 関数から出力される コネクションID 参照パラメータ、 DataSocket Write 関数から出力される コネクションout パラメータを指定できます。

  • cfxdt.png タイプ (バリアント)

    タイプ(バリアント)は、読み取るデータのタイプを指定し、データ出力端子のタイプを定義します。デフォルトのタイプはバリアントで、任意のタイプとなります。

    任意のデータタイプをこの入力に配線し、出力データタイプを定義します。入力データの値は無視されます。

  • ci32.png ミリ秒タイムアウト (10000)

    ミリ秒タイムアウトは、値の更新が接続バッファで使用可能になるまでの待機時間を指定します。

    値の更新を待機がFALSEで、初期値が到着した場合、関数はこの入力を無視して待機しません。デフォルト値は10,000ミリ秒 (10秒) です。

  • cerrcodeclst.png エラー入力 (エラーなし)

    エラー入力は、このノードを実行する前に発生したエラーの状態を示します。この入力は、標準エラー入力として機能します。

  • cbool.png 値の更新を待機 (T)

    値の更新を待機がTRUEの場合、関数は値が更新されるまで待機します。

    接続バッファに未処理データが含まれる場合、関数は次の値を即座に返します。そうでない場合、関数は更新されるまでミリ秒タイムアウトのミリ秒間待機します。タイムアウト時間制限内に値が更新されなかった場合は現在の値が返され、タイムアウトはTRUEになります。値の更新を待機がFALSEの場合、関数は接続バッファに次の値を返し、データがない場合は最後に読み取られた値を返します。

  • iu32.png ステータス

    ステータスは、PSPサーバまたはFieldPointコントローラの警告またはエラーを報告します。31番目のビットが 1の場合、 ステータスは エラーを示す。それ以外の場合、ステータスはステータスコードを示します。

  • iu64.png 品質

    品質は、シェア変数またはNI Publish-Subscribe-Protocol (NI-PSP) データ項目から読み取られたデータの品質です。VIをデバッグする情報については、品質の値を使用します。

    以下の表は、一部の可能な品質値のリストです。

    ビット番号 説明
    1 このシェア変数からの値は、データソースからの最新値でない可能性があります。
    2 センサのエラーです。
    3 一般デバイスのエラー応答です。
    4 サーバのエラーです。
    5 一般通信エラーです。
    6 シェア変数エンジンで変数を検出できません。この変数のデプロイメントに失敗した可能性があります。
    7 シェア変数に既知の値がありません。
    8 シェア変数が非アクティブです。
    10 下限
    11 上限
    12 定数
    13 センサが正確ではありません。
    14 工学単位の制限を超過しました。
    15 一般的なOPCエラー。
    16 数学エラー。
    17 通信リンクに失敗しました。
    18 NI-PSPがサーバにまだ接続されていません。
    19 サーバのDNSルックアップに失敗しました。
    20 サーバに到達できません。
    21 サーバのサービスルックアップに失敗しました。
    22 サーバへの接続が解除されました。
    23 プロセスが見つからないか、応答していません。
    24 このシェア変数のURLの解決に失敗しました。
    25 シェア変数への読み取りアクセスが拒否されました。
    26 このシェア変数のURLが無効です。
    30 ポイントにアクティブなアラームがあります。
    31 サブスクリプションに失敗しました。
    32 32以上の有効ビットが設定されているか、報告されたエラーステータスがあります。
    33 シェア変数のクライアント側の読み取りバッファがいっぱいです。
    34 シェア変数のクライアント側読み取りバッファがオーバーフローしました。
    35 シェア変数のサーバ側書き込みバッファがいっぱいです。
    36 シェア変数のサーバ側書き込みバッファがオーバーフローしました。
  • istr.png 接続出力

    接続出力は、データ接続を指定するデータソースです。

  • ifxdt.png データ

    データは、読み取りの結果です。この関数がタイムアウトする場合、データはこの関数により最後に読み取られた値を返します。この関数がデータを読み取る前にタイムアウトする、またはデータタイプに互換性がない場合は、データ0、または同等の値を返します。

  • ibool.png タイムアウト

    タイムアウトは、更新または初期値を待機中に関数がタイムアウトになる場合、TRUEを返します。

  • ierrcodeclst.png エラー出力

    エラー出力には、エラー情報が含まれます。この出力は、標準エラー出力として機能します。

  • iatrn.png タイムスタンプ

    タイムスタンプは、NI Publish-Subscribe Protocol (NI-PSP) データ項目とシェア変数のタイムスタンプデータを返します。

  • サンプルプログラム

    LabVIEWに含まれている以下のサンプルファイルを参照してください。

    • labview\examples\Data Communication\DataSocket\Simple DataSocket\Simple DataSocket.lvproj