Programming interface
4.1 Functions of the serial interface
SIMATIC 3964R protocol for Windows 9x/XP/7
18
Installation Manual, 01/2013, J31069-D0131-U001-A2-7218
ComSetNotification
comInt
ComSetNotification
(comHandle_t com_handle,
comNotifCall p_callback,
int userID)
With this function, a callback routine can be specified that is called if events occur in the
driver (e.g. received frame). If the "NULL" is transferred as the parameter, the routine is
disabled. This notification method can be considered as an alternative to "ComEnableEvent".
Parameter
com_handle interface handle from ComOpen
com_NotifCall Pointer to the callback routine
userID User-defined ID (any value)
Return value
0 Function successfully completed
< 0 possible error message:
• COM_HANDLE_FALSE
ComGetReadState
comInt
ComGetReadState
(int com_handle)
This function queries the current status of the receive routine and then resets it.
Parameter
com_handle interface handle from ComOpen
Return value
COM_ST_FREE Receive routine is not busy
COM_ST_BUSY A frame is currently being received
COM_ST_SUCCESS A frame was successfully received
< 0 Error status
Notes
● If the current status is "COM_ST_BUSY", the status is not reset.
● The error status can include several errors at the same time. Each bit in the error number
corresponds to an error. The "COM_ST_ERROR" is set in any case. Section "Error and
status m
essages (Page 23)" contains a precise description of the individual errors.
To Next Page
Loading...
Need help?
General