Siemens M20 Terminal Technical Description page 184

Siemens Information and Communication Products
8.4.2.8 UINT GetCommEventMask(idComDev, fnEvtClear)
int idComDev;
int fnEvtClear;
The GetCommEventMask function retrieves and then clears the event word for a communications device.
UINT GetCommEventMask(idComDev, fnEvtClear
Parameter Description
idComDev Specifies the communications device to be examined. The OpenComm function returns this value.
fnEvtClear Specifies which events are to be cleared in the event word. For a list of the event values, see the
description of the SetCommEventMask function
Return value The return value specifies the current event-word value for the specified communications device
if the function is successful. Each bit in the event word specifies whether a given event has occur-
red; a bit is set (to 1) if the event has occurred.
Example None
Comments Before the GetCommEventMask function can record the occurrence of an event, an application
must enable the event by using the SetCommEventMask function.
If the communications device event is a line-status or printer error, the application should call the
GetCommError function after calling GetCommEventMask.
See also GetCommError, OpenComm, SetCommEventMask
8.4.2.9 int GetCommState(idComDev, lpdcb)
int idComDev;
DCB FAR* lpdcb;
The GetCommState function retrieves the device control block for the specified device.
int GetCommState(idComDev, lpdcb
Parameter Description
idComDev Specifies the device to be examined. The OpenComm function returns this value.
lpdcb Points to the DCB structure that is to receive the current device control block. The DCB structure
defines the control settings for the device.
Return value 0 if the function is successful.
Otherwise < 0
Example None
Comments None
See also OpenComm, SetCommState, DCB
Version 8 dated 15.03.00
/* communications device identifier
/* events to clear in the event word
/* communications device identifier
/* address of structure for device control block
*/
*/
*/
*/
Application notes
A
184