Структура COMMPROP


Структура COMMPROP используется функцией GetCommProperties, чтобы возвратить информацию о данном коммуникационном драйвере.

Синтаксис

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;
} COMMPROP;

Члены структуры

wPacketLength

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

wPacketVersion

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

dwServiceMask

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

dwReserved1

Зарезервирован; не используется.

dwMaxTxQueue

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

dwMaxRxQueue

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

dwMaxBaud

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

Значение Предназначение
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 Программируемые доступные скорости передачи данных в бодах
 
dwProvSubType

Тип поставщика информации.

Значение Предназначение
PST_FAX Устройство факсимильной связи - FAX 
PST_LAT Протокол передачи в локальной сети (LAT)
PST_MODEM Модемное устройство
PST_NETWORK_BRIDGE Неопределенный сетевой мост
PST_PARALLELPORT Параллельный порт
PST_RS232 последовательный порт RS-232 
PST_RS422 Порт RS-422
PST_RS423 Порт RS-423
PST_RS449 Порт RS-449
PST_SCANNER Сканирующее устройство
PST_TCPIP_TELNET Набор протоколов TCP/IP Telnet ® 
PST_UNSPECIFIED Неопределенный
PST_X25 Стандарты X.25
dwProvCapabilities
Возможности, предлагаемые поставщиком данных. Этот член структуры может быть одним из следующих значений.

 

Значение Предназначение
PCF_16BITMODE  Поддерживается специальный 16-разрядный режим
PCF_DTRDSR Поддерживаются сигналы DTR (готовности терминала к передаче данных) / DSR (сигнал готовности модема)
PCF_INTTIMEOUTS Поддерживаются интервалы блокировки по времени
PCF_PARITY_CHECK Поддерживается проверка четности
PCF_RLSD Поддерживается RLSD (детектор принимаемого линейного сигнала)
PCF_RTSCTS Поддерживается RTS (сигнал готовности к передаче) / CTS (сигнал готовности к приему)
PCF_SETXCHAR Поддерживается устанавливаемые  XON/XOFF
PCF_SPECIALCHARS Обеспечивается поддержка специальных символов
PCF_TOTALTIMEOUTS Поддержка общей (истекающей) блокировки по времени
PCF_XONXOFF Поддержка XON/XOFF управления потоком
dwSettableParams

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

 

Значение Предназначение
SP_BAUD Скорость передачи данных в бодах
SP_DATABITS Биты данных
SP_HANDSHAKING Подтверждение связи (управление потоком данных)
SP_PARITY Четность
SP_PARITY_CHECK Проверка четности
SP_RLSD RLSD (детектор принимаемого линейного сигнала)
SP_STOPBITS Стоповые биты
dwSettableBaud
Скорости передачи данных в бодах, которые могут использоваться. Значения, см. в члене структуры dwMaxBaud.
wSettableData

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

Значение Предназначение
DATABITS_5 5 битов данных
DATABITS_6 6 битов данных
DATABITS_7 7 битов данных
DATABITS_8 8 битов данных
DATABITS_16 16 битов данных
DATABITS_16X Специальный широкополосный канал через последовательные аппаратные линии
wSettableStopParity

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

 

Значение Предназначение
STOPBITS_10 1 стоповый бит
STOPBITS_15 1.5 стоповых бита
STOPBITS_20 2 стоповых бита
PARITY_NONE Нет четности
PARITY_ODD Проверка на нечетность
PARITY_EVEN Проверка на четность
PARITY_MARK Контроль по единичному биту чётности
PARITY_SPACE Контроль по нулевому биту чётности
dwCurrentTxQueue

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

dwCurrentRxQueue

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

dwProvSpec1

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

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

dwProvSpec2

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

wcProvChar

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

Замечания

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

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

 

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

Смотри также

Обзор Коммуникационные ресурсы, Структуры, используемые коммуникационными ресурсами, GetCommProperties

Размещение и совместимость COMMPROP

К

Windows. NET Server

-

л

Windows XP

Да

и

Windows 2000 Professional

Да -

е

Windows NT Workstation 

Да -

н

Windows Me

Да

т

Windows 98

Да

 

Windows 95

Да

 
С

Windows 2003 Server

Да
е

Windows 2000 Server

Да 
р

Windows NT Server

Да 
в

 

 
е

 

 
р 

 

 
 

Используемая библиотека

-

 

Заголовочный файл

 
 

- объявлено в

Winbase.h

 

- включено в

Windows.h

 

Unicode

 

 

Замечания по платформе

Не имеется

 

Назад в оглавление
На главную страницу
В оглавление справки

Hosted by uCoz