AioSetAiAttachedData

機能

AD変換データに添付するデータの設定を行います。
バスマスタ転送機能を持つデバイスのみで使用できる関数です。
AI-1204Z-PEは対応していません。

この関数はAioSetAiTransferMode関数で変換データ転送方式をユーザーバッファモードに設定した場合に有効になります。
変換データ転送方式がデバイスバッファの場合には使用できません。

書式

Ret = AioSetAiAttachedData ( Id , AttachedData )

引数

Id [ C, C++： short ] [ Python： ctypes.c_short ]
AioInit 関数で取得したデバイスＩＤを指定します。

AttachedData [ C, C++： long ] [ Python： ctypes.c_long ]
AD変換データに加えて添付するデータの種類を以下の範囲からマクロもしくは数値で指定します。
AttachedDataはビット単位で以下のような意味を持ち、これらを組み合わせて指定可能です。

戻り値

Ret [ C, C++： long ] [ Python： ctypes.c_long ]

初期値

すべてのデバイスでAttachedData = 0

説明

AD変換データに添付するデータとして、以下の添付データを選択する事ができます。

添付データは、変換データと一緒にユーザーメモリへ転送されます。
添付データはすべての種類で４バイト（１パケット）のバッファを使用します。

このため、添付データの指定状況に応じて、１サンプリングあたりに必要なパケット数が変化することに注意してください。
AioGetAiSamplingDataSize関数を使用すれば、１サンプリングあたりに必要なパケット数を取得できます。

デバイスが動作中の場合、この関数は実行できません。

■添付データ転送イメージ

添付データは、AD変換データに続いて
１．アナログ入力付属情報
２．アナログ出力データ
３．デジタル入出力データ
４．カウンタチャネル０データ
５．カウンタチャネル１データ
の順序で転送されます。

使用する添付データの種類に関わらず、若い数字のデータから順に転送されます。

各々の添付データの詳細については、用語集の「AD変換データに添付するデータ」トピックを参照ください。

デバイス別仕様

使用例

アナログ入力付属情報を添付データに設定します。