Структура 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; |
Размер всего пакета данных, независимо от объема затребованных данных, в байтах.
Версия структуры.
Битовая маска, указывающая какие услуги осуществляются этим поставщиком данных. Значение SP_SERIALCOMM всегда определяется для поставщиков средств коммуникаций, включая поставщиков модемов.
Зарезервирован; не используется.
Максимальный размер внутреннего буфера вывода данных драйвера, в байтах. Значение нуля указывает, что максимальное значение не касается поставщика последовательных данных.
Максимальный размер внутреннего буфера ввода данных драйвера, в байтах. Значение нуля указывает, что максимальное значение не касается поставщика последовательных данных.
Максимальная допустимая скорость передачи данных в бодах (в битах в секунду). Этот член структуры может быть одним из следующих значений.
Значение | Предназначение |
---|---|
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 | Программируемые доступные скорости передачи данных в бодах |
Тип поставщика информации.
Значение | Предназначение |
---|---|
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 |
Значение | Предназначение |
---|---|
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 управления потоком |
Коммуникационный параметр, который может изменяться. Этот член структуры может быть одним из следующих значений.
Значение | Предназначение |
---|---|
SP_BAUD | Скорость передачи данных в бодах |
SP_DATABITS | Биты данных |
SP_HANDSHAKING | Подтверждение связи (управление потоком данных) |
SP_PARITY | Четность |
SP_PARITY_CHECK | Проверка четности |
SP_RLSD | RLSD (детектор принимаемого линейного сигнала) |
SP_STOPBITS | Стоповые биты |
Число битов данных, которые могут быть установлены. Этот член структуры может быть одним из следующих значений.
Значение | Предназначение |
---|---|
DATABITS_5 | 5 битов данных |
DATABITS_6 | 6 битов данных |
DATABITS_7 | 7 битов данных |
DATABITS_8 | 8 битов данных |
DATABITS_16 | 16 битов данных |
DATABITS_16X | Специальный широкополосный канал через последовательные аппаратные линии |
Стоповый бит и установки четности, которые могут быть выбраны. Этот член структуры может быть одним из следующих значений.
Значение | Предназначение |
---|---|
STOPBITS_10 | 1 стоповый бит |
STOPBITS_15 | 1.5 стоповых бита |
STOPBITS_20 | 2 стоповых бита |
PARITY_NONE | Нет четности |
PARITY_ODD | Проверка на нечетность |
PARITY_EVEN | Проверка на четность |
PARITY_MARK | Контроль по единичному биту чётности |
PARITY_SPACE | Контроль по нулевому биту чётности |
Размер внутреннего буфера вывода данных драйвера, в байтах. Значение нуля указывает, что это значение недоступно.
Размер внутреннего буфера ввода данных драйвера, в байтах. Значение нуля указывает, что значение недоступно.
Определяемые поставщиком данные. Приложения должны игнорировать этот член структуры, если они не детализировали информацию о формате данных, требуемых поставщиком.
Установите этот член структуры в COMMPROP_INITIALIZED перед вызовом функции GetCommProperties, чтобы указать, что член структуры wPacketLength является уже допустимым.
Определяемые поставщиком данные. Приложения должны игнорировать этот член структуры, если они не детализировали информацию о формате данных, требуемых поставщиком.
Определяемые поставщиком данные. Приложения должны игнорировать этот член структуры, если они не детализировали информацию о формате данных, требуемых поставщиком.
Замечания
Содержание членов 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 |
|
|
Замечания по платформе |
Не имеется |