Function
Converts the specified channel one time, the conversion data are returned in binary value. This function supports multi-process.
Format
Ret = AioSingleAi ( Id , AiChannel , AiData )
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 to be converted.
AiData
[ C, C++ : long * ] [ Python : ctypes.POINTER(ctypes.c_long) ]
Specifies the address of the variable that stores the converted data. The
converted data are stored in binary value.
Resolution of device is 10 bit |
0 to 1,023 |
Resolution of device is 12 bit |
0 to 4,095 |
Resolution of device is 16 bit |
0 to 65,535 |
Resolution of device is 24 bit |
0 to 16,777,215 |
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 |
11420 |
The
value of AiChannel is outside the designated range of the function |
11421 |
Pointer
to AiData is NULL |
20001 |
This function can't be used by this device |
20002 |
Can
not use while by another device works |
21420 |
The value of AiChannel is outside the designated range of the device being used |
21423 |
The channel which isn't being used for the conversion is specified |
Remarks
This function cannot be used on devices without
the analog input function.
If the device is in operation, the function cannot be performed.
When you use this function and "continuous functions", please refer "How to use simple functions and continuous functions at the same time" topics.
Example
Converts Channel 0 one time.
C, C++ |
long
Ret; |
Python |
Ret
= ctypes.c_long() |
See also
Channel Multi-process Resolution Transfer data format