Compartilhar via


COMMPROP

A version of this page is also available for

Windows Embedded CE 6.0 R3

4/8/2010

This structure is used by the GetCommProperties function to return specific communication support driver data.

Syntax

typedef struct _COMMPROP {
  WORD wPacketLength;
  WORD wPacketVersion;
  DWORD dwServiceMask;
  DWORD dwReserved1;
  DWORD dwMaxTxQueue;
  DWORD dwMaxRxQueue;
  DWORD dwMaxBaud;
  DWORD dwProvSubType;
  DWORD dwProvCapabilities;
  DWORD dwSettableParams;
  DWORD dwSettableBaud;
  WORD wSettableData;
  WORD wSettableStopParity;
  WORD dwCurrentTxQueue;
  DWORD dwCurrentRxQueue;
  DWORD dwProvSpec1;
  DWORD dwProvSpec2;
  WCHAR wcProvChar[1];
} COMMPROP;

Members

  • wPacketLength
    Specifies the size, in bytes, of the data packet, regardless of the amount of data requested.
  • wPacketVersion
    Specifies the version of the structure.
  • dwServiceMask
    Specifies a bitmask indicating which services are implemented by this provider.

    The SP_SERIALCOMM value is always specified for communications providers, including modem providers.

  • dwReserved1
    Reserved; do not use.
  • dwMaxTxQueue
    Specifies the maximum size, in bytes, of the driver's internal output buffer.

    A value of zero indicates that no maximum value is imposed by the serial provider.

  • dwMaxRxQueue
    Specifies the maximum size, in bytes, of the driver's internal input buffer.

    A value of zero indicates that no maximum value is imposed by the serial provider.

  • dwMaxBaud

    Value Description

    BAUD_075

    75 bps

    BAUD_110

    110 bps

    BAUD_134_5

    134.5 bps

    BAUD_150

    150 bps

    BAUD_300

    300 bps

    BAUD_600

    600 bps

    BAUD_1200

    1200 bps

    BAUD_1800

    1800 bps

    BAUD_2400

    2400 bps

    BAUD_4800

    4800 bps

    BAUD_7200

    7200 bps

    BAUD_9600

    9600 bps

    BAUD_14400

    14400 bps

    BAUD_19200

    19200 bps

    BAUD_38400

    38400 bps

    BAUD_56K

    56K bps

    BAUD_57600

    57600 bps

    BAUD_115200

    115200 bps

    BAUD_128K

    128K bps

    BAUD_USER

    Programmable baud rates available

  • dwProvSubType

    Value Description

    PST_FAX

    FAX device

    PST_LAT

    LAT protocol

    PST_MODEM

    Modem device

    PST_NETWORK_BRIDGE

    Unspecified network bridge

    PST_PARALLELPORT

    Parallel port

    PST_RS232

    RS-232 serial port

    PST_RS422

    RS-422 port

    PST_RS423

    RS-423 port

    PST_RS449

    RS-449 port

    PST_SCANNER

    Scanner device

    PST_TCPIP_TELNET

    TCP/IP Telnet® protocol

    PST_UNSPECIFIED

    Unspecified

    PST_X25

    X.25 standards

  • dwProvCapabilities

    Value Description

    PCF_16BITMODE

    Special 16-bit mode is supported.

    PCF_DTRDSR

    DTR (Data Terminal Ready) and DSR (Data Set Ready) are supported.

    PCF_INTTIMEOUTS

    Interval timeouts are supported.

    PCF_PARITY_CHECK

    Parity checking is supported.

    PCF_RLSD

    RLSD (Receive Line Signal Detect) is supported.

    PCF_RTSCTS

    RTS (Request to Send) and CTS (Clear to Send) are supported.

    PCF_SETXCHAR

    XON and XOFF are supported.

    PCF_SPECIALCHARS

    Special character support is provided.

    PCF_TOTALTIMEOUTS

    Total elapsed timeouts are supported.

    PCF_XONXOFF

    XON and XOFF flow control are supported.

  • dwSettableParams

    Value Description

    SP_BAUD

    Baud rate

    SP_DATABITS

    Data bits

    SP_HANDSHAKING

    Handshaking (flow control)

    SP_PARITY

    Parity

    SP_PARITY_CHECK

    Parity checking

    SP_RLSD

    Receive Line Signal Detect

    SP_STOPBITS

    Stop bits

  • dwSettableBaud
    Indicates the baud rates that can be used.

    For values, see the dwMaxBaud member.

  • wSettableData

    Value Description

    DATABITS_5

    5 data bits

    DATABITS_6

    6 data bits

    DATABITS_7

    7 data bits

    DATABITS_8

    8 data bits

    DATABITS_16

    16 data bits

    DATABITS_16X

    Special wide path through serial hardware lines

  • wSettableStopParity

    Value Description

    PARITY_EVEN

    Even parity

    PARITY_MARK

    Mark parity

    PARITY_NONE

    No parity

    PARITY_ODD

    Odd parity

    PARITY_SPACE

    Space parity

    STOPBITS_10

    1 stop bit

    STOPBITS_15

    1.5 stop bits

    STOPBITS_20

    2 stop bits

  • dwCurrentTxQueue
    Specifies the size, in bytes, of the driver's internal output buffer. A value of zero indicates that the value is unavailable.
  • dwCurrentRxQueue
    Specifies the size, in bytes, of the driver's internal input buffer. A value of zero indicates that the value is unavailable.
  • dwProvSpec1
    Specifies provider-specific data. Applications should ignore this member unless specific data about the data format required by the provider is available.

    Set this member to COMMPROP_INITIALIZED before calling the GetCommProperties function to indicate that the wPacketLength member is already valid.

  • dwProvSpec2
    Specifies provider-specific data.

    Applications should ignore this member unless specific data about the data format required by the provider is available.

  • wcProvChar
    Specifies provider-specific data.

    Applications should ignore this member unless specific data about the data format required by the provider is available.

Requirements

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

See Also

Reference

Serial Communications Structures
GetCommProperties