Share via

Структура COMMPROP (winbase.h)

  • Статья

Содержит сведения о драйвере связи.

Синтаксис

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;
  DWORD dwCurrentTxQueue;
  DWORD dwCurrentRxQueue;
  DWORD dwProvSpec1;
  DWORD dwProvSpec2;
  WCHAR wcProvChar[1];
} COMMPROP, *LPCOMMPROP;

Члены

wPacketLength

Размер всего пакета данных, независимо от запрошенного объема данных, в байтах.

wPacketVersion

Версия структуры.

dwServiceMask

Битовая маска, указывающая, какие службы реализуются этим поставщиком. Значение SP_SERIALCOMM всегда указывается для поставщиков связи, включая поставщиков модемов.

dwReserved1

Защищены; не использовать.

dwMaxTxQueue

Максимальный размер внутреннего выходного буфера драйвера в байтах. Нулевое значение указывает на то, что поставщик последовательных последовательных служб не задает максимальное значение.

dwMaxRxQueue

Максимальный размер внутреннего входного буфера драйвера (в байтах). Нулевое значение указывает на то, что поставщик последовательных последовательных служб не задает максимальное значение.

dwMaxBaud

Максимально допустимая скорость передачи данных в битах в секунду (б/с). Этот элемент может быть одним из следующих значений.

Значение Значение
BAUD_075
0x00000001
 75 бит/с
BAUD_110
0x00000002
 110 бит/с
BAUD_134_5
0x00000004
 134,5 бит/с
BAUD_150
0x00000008
 150 бит/с
BAUD_300
0x00000010
 300 бит/с
BAUD_600
0x00000020
 600 бит/с
BAUD_1200
0x00000040
 1200 бит/с
BAUD_1800
0x00000080
 1800 бит/с
BAUD_2400
0x00000100
 2400 бит/с
BAUD_4800
0x00000200
 4800 бит/с
BAUD_7200
0x00000400
 7200 бит/с
BAUD_9600
0x00000800
 9600 бит/с
BAUD_14400
0x00001000
 14400 бит/с
BAUD_19200
0x00002000
 19200 бит/с
BAUD_38400
0x00004000
 38400 бит/с
BAUD_56K
0x00008000
 56 ТЫС.бит/с
BAUD_57600
0x00040000
 57600 бит/с
BAUD_115200
0x00020000
 115200 бит/с
BAUD_128K
0x00010000
 128 КБ/с
BAUD_USER
0x10000000
 Программируемая скорость передачи данных.

dwProvSubType

Тип поставщика связи.

Значение Значение
PST_FAX
0x00000021
 Устройство FAX
PST_LAT
0x00000101
 Протокол LAT
PST_MODEM
0x00000006
 Модемное устройство
PST_NETWORK_BRIDGE
0x00000100
 Неуказанным сетевым мостом
PST_PARALLELPORT
0x00000002
 Параллельный порт
PST_RS232
0x00000001
 Последовательный порт RS-232
PST_RS422
0x00000003
 Порт RS-422
PST_RS423
0x00000004
 Порт RS-423
PST_RS449
0x00000005
 Порт RS-449
PST_SCANNER
0x00000022
 Устройство сканера
PST_TCPIP_TELNET
0x00000102
 Протокол TCP/IP Telnet
PST_UNSPECIFIED
0x00000000
 Не указан
PST_X25
0x00000103
 Стандарты X.25

dwProvCapabilities

Битовая маска, указывающая возможности, предлагаемые поставщиком. Этот элемент может быть сочетанием следующих значений.

Значение Значение
PCF_16BITMODE
0x0200
 Поддерживается специальный 16-разрядный режим
PCF_DTRDSR
0x0001
 Поддерживается DTR (data-terminal-ready)/DSR (data-set-ready)
PCF_INTTIMEOUTS
0x0080
 Поддерживаемые интервалы времени ожидания
PCF_PARITY_CHECK
0x0008
 Проверка четности поддерживается
PCF_RLSD
0x0004
 Поддерживается RLSD (receive-line-signal-detect)
PCF_RTSCTS
0x0002
 Поддерживается RTS (запрос к отправке)/CTS (очистка для отправки)
PCF_SETXCHAR
0x0020
 Поддерживается настройка XON/XOFF
PCF_SPECIALCHARS
0x0100
 Предоставлена поддержка специальных символов
PCF_TOTALTIMEOUTS
0x0040
 Общее (затраченное) время ожидания поддерживается
PCF_XONXOFF
0x0010
 Поддерживается управление потоком XON/XOFF

dwSettableParams

Битовая маска, указывающая параметры связи, которые можно изменить. Этот элемент может быть сочетанием следующих значений.

Значение Значение
SP_BAUD
0x0002
 Скорость (бит/с)
SP_DATABITS
0x0004
 Биты данных
SP_HANDSHAKING
0x0010
 Подтверждение (управление потоком)
SP_PARITY
0x0001
 Parity
SP_PARITY_CHECK
0x0020
 Проверка четности
SP_RLSD
0x0040
 RLSD (receive-line-signal-detect)
SP_STOPBITS
0x0008
 Стоп-биты

dwSettableBaud

Тарифы baud, которые можно использовать. Значения см. в элементе dwMaxBaud .

wSettableData

Битовая маска, указывающая количество битов данных, которые можно задать. Этот элемент может быть сочетанием следующих значений.

Значение Значение
DATABITS_5
0x0001
 5 битов данных
DATABITS_6
0x0002
 6 битов данных
DATABITS_7
0x0004
 7 битов данных
DATABITS_8
0x0008
 Биты данных: 8
DATABITS_16
0x0010
 16 бит данных
DATABITS_16X
0x0020
 Специальный широкий путь через последовательные аппаратные линии

wSettableStopParity

Битовая маска, указывающая параметры стоп-бита и четности, которые можно выбрать. Этот элемент может быть сочетанием следующих значений.

Значение Значение
STOPBITS_10
0x0001
 Стоповые биты: 1
STOPBITS_15
0x0002
 1,5 стоп-бита
STOPBITS_20
0x0004
 2 стоп-бита
PARITY_NONE
0x0100
 Без контроля четности
PARITY_ODD
0x0200
 Нечетная четность
PARITY_EVEN
0x0400
 Четная четность
PARITY_MARK
0x0800
 Пометка четности
PARITY_SPACE
0x1000
 Четность пространства

dwCurrentTxQueue

Размер внутреннего выходного буфера драйвера в байтах. Нулевое значение указывает, что значение недоступно.

dwCurrentRxQueue

Размер внутреннего входного буфера драйвера в байтах. Нулевое значение указывает, что значение недоступно.

dwProvSpec1

Любые данные, относящиеся к поставщику. Приложения должны игнорировать этот элемент, если у них нет подробных сведений о формате данных, необходимых поставщику.

Установите для этого элемента значение COMMPROP_INITIALIZED перед вызовом функции GetCommProperties , чтобы указать, что член wPacketLength уже действителен.

dwProvSpec2

Любые данные, относящиеся к поставщику. Приложения должны игнорировать этот элемент, если у них нет подробных сведений о формате данных, необходимых поставщику.

wcProvChar[1]

Любые данные, относящиеся к поставщику. Приложения должны игнорировать этот элемент, если у них нет подробных сведений о формате данных, необходимых поставщику.

Комментарии

Содержимое членов dwProvSpec1, dwProvSpec2 и wcProvChar зависит от подтипа поставщика (задается членом dwProvSubType ).

Если подтип поставщика PST_MODEM, эти члены используются следующим образом.

Значение Значение
dwProvSpec1 Не используется.
dwProvSpec2 Не используется.
wcProvChar Содержит структуру MODEMDEVCAPS .

Требования

   
Минимальная версия клиента Windows XP
Минимальная версия сервера Windows Server 2003
Верхняя часть winbase.h (включая Windows.h)

См. также раздел

GetCommProperties