Function
Sets the analog input channel used for conversion
to be used/unused.
This function is used by Z-series only.
Format
Ret = AioSetAiChannel ( Id , AiChannel, Enabled )
Parameters
Id
[ C, C++ : short ] [ Python : ctypes.c_short ]
Specifies the Device ID retrieved from AioInit function.
AiChannel
[ C, C++ : short ] [ Python : ctypes.c_short ]
Specifies the channel you want to set to be used/unused.
Enabled [ C, C++ : short ] [ Python : ctypes.c_short ]
Sets the channel to be used/unused.
0 |
Unused channel |
1 |
Used channel |
Return value
Ret [ C, C++ : long ] [ Python : ctypes.c_long ]
Return values |
Content |
0 |
Normality completion |
7 |
Execute AioResetDevice function because the device has recovered from standby mode |
10001 |
Invalid
Id was specified |
10002 |
AIO
driver can't be called |
12480 |
The value of AiChannel is outside the designated range of the function |
20001 |
This function can't be used by this device |
20003 |
Can
not use because another process is using the device |
22480 |
The value of AiChannel is outside the designated range of the device being used |
Initial value
All devices, channel 0 is used,
and channel 1, channel 2, channel 3 are unused.
Remarks
This function cannot be used on devices without
the analog input function.
This function can be executed if the device is working.
This function is used by Z-series only.
Notes that data handling differs between
when specifies device buffer to transfer mode and when specifies user
buffer to transfer mode.
(For transfer mode, please refer to AioSetAiTransferMode.)
Device buffer mode When setting the channels to be used in device buffer mode, For example, when using 2 channels in total, 0ch and 3ch, |
... |
Similarly, when using 3 channels
in total, 0ch, 2ch and 3ch, |
... |
User buffer mode When setting channels to be used in user buffer mode as well
as device buffer mode, the data is stored in ascending order of
channel number. |
... |
Similarly, when using 3 channels in total, 0ch, 2ch and 3ch, |
... |
Example
Sets the set channel to be used/unused.
C, C++ |
long Ret; |
Python |
Ret = ctypes.c_long() |
See also
AioGetAiChannel AioGetAiChannels AioGetAiMaxChannels