Programming interface
4.1 Functions of the serial interface
SIMATIC 3964R protocol for Windows 9x/XP/7
16
Installation Manual, 01/2013, J31069-D0131-U001-A2-7218
Parameter
com_handle
interface handle from
ComOpen
com_event
Event to be enabled
possible functions: COM_READ_EVENT, COM_WRITE_EVENT (both
ORed)
user_id
ID to be assigned by the user
msg
Message number to be assigned by the user
Return value
X
Screen with the current events prior to the call
Notes
● If an asynchronous send or receive call is completed and if the corresponding event is
activated using this routine, a Windows message is sent to the window with the handle
from
ComOpen
with the message ID "msg". The data of this message can be queried with
the help of "COMGetNotify". The "user_id" is sent with every message for simpler
message identification.
● "user_id" and "msg" are used only for the events specified in this call. By calling the
"COMEnableEvent" function several times it is therefore possible to combine various
message types for reading and writing.
ComDisableEvent
comInt
ComDisableEvent
(int com_handle,
int com_event)
This function disables events (for checking the asynchronous transfer).
Parameter
com_handle
interface handle from
ComOpen
com_event
Event to be disabled
possible functions: COM_READ_EVENT, COM_WRITE_EVENT (both
ORed)
Return value
X
Screen with the current events prior to the call