Application notes
Version 8 dated 15.03.00 184
Siemens Information and Communication Products
A
8.4.2.8 UINT GetCommEventMask(idComDev, fnEvtClear)
int idComDev; /* communications device identifier */
int fnEvtClear; /* events to clear in the event word */
The GetCommEventMask function retrieves and then clears the event word for a communications device.
8.4.2.9 int GetCommState(idComDev, lpdcb)
int idComDev; /* communications device identifier */
DCB FAR* lpdcb; /* address of structure for device control block */
The GetCommState function retrieves the device control block for the specified 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
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
To Next Page
Loading...
Need help?
General