Function
Registers the callback function that is called
when the events relative to analog output raise.
Format
Ret = AioSetAoCallBackProc ( Id , CallBackProc , AoEvent , Param)
Parameters
Id
[ C, C++ : short ] [ Python : ctypes.c_short ]
Specifies the Device ID retrieved from AioInit function.
CallBackProc
[ C, C++ : long * ] [ Python : ctypes.POINTER(ctypes.c_long) ]
Specifies the address of the callback function.
AoEvent
[ C, C++ : long ] [ Python : ctypes.c_long ]
Specifies the event factor from the following range in macro or value that
calls the callback function.
AoEvent has the following meanings in bit, it can be specified by a combination
of these bits.
The available event factor is based on whether the device buffer is used or whether the user buffer is used.
Event factor |
Using Device buffer |
Macro |
Value |
Yes |
AOE_START |
00000002H |
|
Yes |
AOE_RPTEND |
00000010H |
|
Yes |
AOE_END |
00000020H |
|
Yes |
AOE_DATA_NUM |
00000080H |
|
Yes |
AOE_SCERR |
00020000H |
|
Yes |
AOE_DAERR |
00040000H |
When "Event that the specified number of data are output" is used, set the number of generating that raises the event by using AioSetAoEventSamplingTimes function.
Param
[ C, C++ : void * ] [ Python : ctypes.c_void_p ]
Specifies the parameter address passed to the callback function.
If the parameter isn't necessary, specify NULL.
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 |
20001 |
This function can't be used by this device |
20002 |
Can
not use while by another device works |
20003 |
Can
not use because another process is using the device |
Remarks
Registers the callback function using in this function, the callback function is called when any event raised in the device.
This function cannot be used on devices without
the analog output function.
If the device is in operation, the function cannot be performed..
When AioStopAo function is performed, the callback function isn't called.
You should not execute the functions that start/stop devices operation in the callback routine.
For Ethernet devices
If communication with the device is lost, the process will be unregistered and will no longer receive event notifications.
If you want to perform event notification again, please make the settings again using this function.
Example
Registers the callback function in "Event that device operation end" and "Event that the specified number of data are output" factor.
C, C++ |
long
Ret; |
Python |
Ret
= ctypes.c_long() |
Callback Function
Format
Ret = CallBackProc ( Id , Message , wParam , lParam , Param )
Parameters
Id
[ C, C++ : short ] [ Python : ctypes.c_short ]
The ID retrieved from AioInit is passed.
Message
[ C, C++ : short ] [ Python : ctypes.c_short ]
The message ID is passed that cause the callback function to be called
Message ID is any of the following value.
Analog output message factor |
Macro |
Value |
AIOM_AOE_START |
1020H |
|
AIOM_AOE_RPTEND |
1021H |
|
AIOM_AOE_END |
1022H |
|
AIOM_AOE_DATA_NUM |
1023H |
|
AIOM_AOE_SCERR |
1025H |
|
AIOM_AOE_DAERR |
1026H |
wParam
[ C, C++ : long ] [ Python : ctypes.c_long ]
The parameter is passed from the driver. It isn't used now.
lParam
[ C, C++ : long ] [ Python : ctypes.c_long ]
The parameter peculiar to event is passed.
Event factor |
Parameter |
Event that DA conversion start |
None |
Event that repeat end |
The current number of repeats |
Event that device operation end |
The current number of generating |
Event that the specified number of data are outputted |
The current number of generating |
Event that generating clock period error |
The current number of generating |
Event that DA conversion error |
The current number of generating |
Param
[ C, C++ : void * ] [ Python : ctypes.c_void_p ]
The parameter specified in the function AioSetAoCallBackProc is passed.
NULL is stored in this when NULL is specified in the parameter.