ReadLatchedUserDataBuffer
バッファ処理された画像取り込みを必要とするアプリケーションで使用する場合は、[ネットワークの設定] ダイアログで現在有効にされているファクトリ通信プロトコルの [User Data] フィールドに含まれるデータを読み取り (消費し)、画像取り込みトリガでデータを取得します。取得されたデータは、取り込まれた画像データとともに運ばれ、この関数を通じて、スプレッドシートに読み込まれます。参照されるバッファ構造体は FormatInputBuffer 関数によって作成されたもので、受信されたデータの認識方法を定義します。
ReadLatchedUserDataBufferの入力パラメータ
Syntax:ReadLatchedUserDataBuffer(イベント,バッファ,プロトコル,接続の検証,バイト/ワードオーダ)
イベント |
データを読み取る更新イベントを指定します。このパラメータは、次のいずれかを参照している必要があります。
|
|||||||||||||||||||||||||||||||||||||||||||||
バッファ |
FormatInputBuffer 関数によって作成された、バッファデータ構造体への参照を指定します。この構造体は受信されたデータの解釈方法を定義します。 注 : 入力データの最大長は、4,000 バイトです。
|
|||||||||||||||||||||||||||||||||||||||||||||
プロトコル |
ユーザデータの読み取り元となるプロトコルを指定します。
|
|||||||||||||||||||||||||||||||||||||||||||||
接続の検証 |
この関数で接続の検証を行うかどうかを指定します。有効にされている場合、選択されたプロトコルでアクティブな周期接続が行われていないと、#ERR が返されます。 EtherNet/IP の場合、前回の再起動の後、非明示的な接続が確立されていない場合は、#ERR が返されることはありません。 非明示的なメッセージが使用されない場合は、#ERR が返されることなく、センサで明示的にデータを受信することができます。 |
|||||||||||||||||||||||||||||||||||||||||||||
バイト/ワードオーダ |
関数によって読み込まれるワードとバイトのビット順序を指定します。 注 : このパラメータは、In-Sight ファームウェア 5.1.0 以上を実行している In-Sight ビジョンシステムだけで使用できます。
例AB (1 ワードサイズの値): A = 最上位バイト、B = 最下位バイト:
12AB (2 ワードサイズの値): 1 = 最上位バイト、B = 最下位バイト:
|
ReadLatchedUserDataBufferの出力
戻り値 | クライアントによって送信されたデータを含む UserData データ構造体。不正な入力パラメータが含まれていた場合、クライアントからの接続が確立されていない場合、または接続の確立後、データバッファへの書き込みが行われていない場合には #ERR が返されます。 |
結果 | UserData データ構造体内のデータには GetBufferData 関数を使用してアクセスします。 |