Programming interface
4.1 Functions of the serial interface
SIMATIC 3964R protocol for Windows 9x/XP/7
Installation Manual, 01/2013, J31069-D0131-U001-A2-7218
17
ComGetNotify
comInt
ComGetNotify
(WPARAM wParam,
LPARAM lParam,
int *user_id,
int *event_ptr,
int *state_ptr,
init *handle_ptr)
Messages that are sent to the application at the end of communications operations (if they
have been enabled with "COMEnableEvent") contain further information about the triggering
operation. These are coded in the message parameters "wParam" and "IParam" and can be
extracted using this function.
Parameter
wParam
"wParam" parameter of the incoming message
lParam
"IParam" parameter of the incoming message
*user_id
Pointer to storage space for the ID assigned by the user when calling
"COMEnableEvent"
*event_ptr
Pointer to the storage location for event type
*state_ptr
Pointer to the storage location for the status of the completed operation that
triggered the message
*handle_ptr
Pointer to storage location for the interface handle from
ComOpen
Return value
0
Function successfully completed
≠ 0
possible error message:
•
COM_UNKNOWN_EVENT
Notes
● If "NULL" is transferred with any pointer parameter, the corresponding information is not
returned.
● The routine runs several basic plausibility checks of the values of the message
parameters, a full check is however not possible.