@WaitNTComPortEvent

Only for Engine under Windows!

Waits for a specific event that occurs on the COM port identified by OSCOMHANDLE OSCOMHANDLE1. If FN MASK2 is not specified, the current setting applies. Otherwise, the valid event mask is set to the passed value before the actual wait begins.

FN MASK2:
Bit   HEX   C symbol   Meaning
1      0001   EV_RXCHAR   A character was received and added to buffer
2      0002   EV_RXFLAG   An event character was received
3      0004   EV_TXEMPTY   The last character in output buffer was sent
4      0008   EV_CTS   The CTS signal changed state
5      0010   EV_DSR   The DSR signal changed state
6      0020   EV_RLSD   A RLSD (DCD) signal changed state
7      0040   EV_BREAK   A break was detected on input
8      0080   EV_ERR   A line-status error has occurred
9      0100   EV_RING   A ring indicator was detected

Example: @WaitNTComPortEvent(OSCOMHANDLE1;MASK2);

OSCOMHANDLE1:=@OpenNTComPort("COM1");
@WaitNTComPortEvent(OSCOMHANDLE1;256);
@LogReport("Ring-detect: "+@Text(@Now));
@OSCOMHANDLE1:=@CloseNTComPort(OSCOMHANDLE1);

Opens a COM port, waits until a ring is signaled, outputs the time to the log file, and then closes it again.

Note : This text was machine-translated and may contain inaccuracies.