Important:
This is retired content. This content is outdated and is no longer being maintained. It is provided as a courtesy for individuals who are still using these technologies. This content may contain URLs that were valid when originally published, but now link to sites or pages that no longer exist.
A version of this page is also available for
4/8/2010

This structure contains communication device data.

This structure is filled by the ClearCommErrorfunction.

Syntax 

typedef struct _COMSTAT {
  DWORD 
fCtsHold :1;
  DWORD 
fDsrHold :1;
  DWORD 
fRlsdHold :1;
  DWORD 
fXoffHold :1;
  DWORD 
fXoffSent :1;
  DWORD 
fEof :1;
  DWORD 
fTxim :1;
  DWORD 
fReserved :25;
  DWORD 
cbInQue;
  DWORD 
cbOutQue;
} COMSTAT, *LPCOMSTAT;

Members

fCtsHold

Specifies if the transmission is waiting to receive the clear-to-send (CTS) signal. If this member is set to TRUE, the transmission is waiting.

fDsrHold

Specifies if the transmission is waiting to receive the data-set-ready (DSR) signal. If this member is set to TRUE, the transmission is waiting.

fRlsdHold

Specifies whether the transmission is waiting to receive the receive-line-signal-detect (RLSD) signal. If this member is set to TRUE, the transmission is waiting.

fXoffHold

Specifies whether the transmission is waiting because the XOFF character was received. If this member is set to TRUE, the transmission is waiting.

fXoffSent

Specifies whether the transmission is waiting because the XOFF character was transmitted. If this member is set to TRUE, the transmission is waiting.

Transmission stops when the XOFF character is transmitted to a system that takes the next character as XON, regardless of the actual character.

fEof

Specifies whether the end-of-file (EOF) character has been received. If this member is set to TRUE, the EOF character has been received.

fTxim

If this member is set to TRUE, a character queued for transmission has come to the communication device from the TransmitCommCharfunction. The communication device transmits such a character ahead of other characters in the device's output buffer.

fReserved

Reserved; do not use.

cbInQue

Specifies the number of bytes received by the serial provider, but not yet read by ReadFile.

cbOutQue

Specifies the number of bytes of user data remaining to be transmitted for all write operations.

Requirements

Header winbase.h
Windows Embedded CE Windows CE 1.0 and later
Windows Mobile Windows Mobile Version 5.0 and later

See Also