AioSetAiChannels


機能

変換に使用するアナログ入力チャネル数の設定を行います。

書式

Ret = AioSetAiChannels ( Id , AiChannels )

引数

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

AiChannels [ C, C++: short ] [ Python: ctypes.c_short ]
変換に使用するチャネル数を指定します。

戻り値

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

戻り値

内容

0

正常終了

7

スタンバイモードから復帰したため、AioResetDevice関数を実行してください

10001

無効なIDが指定されました
関数に指定するIDは、AioInitで取得したIDを使用してください。

10002

ドライバを呼び出せません
始めにAioInit関数を実行しください。

11020

AiChannelsの値が関数の指定範囲外です
アナログ入力チャネル数は 1≦AiChannels≦最大チャネル数 の範囲で指定してください。

20001

使用しているデバイスではこの関数を使用することができません

20002

デバイスが動作中のため実行できません
この関数を使用するには、アナログ入力動作が停止している必要があります。

20003

他のプロセスがデバイスを使用しているため、実行できません
他のプロセスがデバイスを使用しているときは、マルチプロセス対応関数以外実行できません。

21020

デバイスの最大チャネル数を超えているため、最大チャネル数で設定しました
設定は自動的に最大チャネル数に変更されます。

初期値

すべてのデバイスで1チャネル使用

説明

変換はこの関数で設定したチャネル数だけ行われます。
チャネル変換順序は、0, 1, 2, ・・・の順になります。
アナログ入力機能を持たないデバイスでは使用できません。
デバイスが動作中の場合、この関数は実行できません。

AI-1204Z-PE のZ-シリーズデバイスの場合、AioSetAiChannel関数による設定には影響されず、
0ch から連続する指定チャネル分が変換対象チャネルとなります。

用途に応じて、AioSetAiChannels関数もしくは、AioSetAiChannel関数のいずれかをご使用ください。

使用例

アナログ入力に2チャネル使用します。

C, C++

long Ret;
Ret = AioSetAiChannels ( Id , 2 );
 

Python

Ret = ctypes.c_long()
Ret.value = caio.AioSetAiChannels ( Id , 2 )
 

関連項目

AioGetAiChannels AioGetAiMaxChannels