На главную

On-line справка по Win32 API

Написать письмо
БЕСПЛАТНАЯ ежедневная online лотерея! Выигрывай каждый день БЕСПЛАТНО!
Список всех статей A-B-C-D-E-F-G-H-I-J-K-L-M-N-O-P-Q-R-S-T-U-V-W-X-Y-Z | Скачать Вниз

COMMPROP



The COMMPROP structure is used by the GetCommProperties function to return information about a given communications driver.

typedef struct _COMMPROP { // cmmp
WORD wPacketLength; // packet size, in bytes
WORD wPacketVersion; // packet version
DWORD dwServiceMask; // services implemented
DWORD dwReserved1; // reserved
DWORD dwMaxTxQueue; // max Tx bufsize, in bytes
DWORD dwMaxRxQueue; // max Rx bufsize, in bytes
DWORD dwMaxBaud; // max baud rate, in bps
DWORD dwProvSubType; // specific provider type

DWORD dwProvCapabilities; // capabilities supported
DWORD dwSettableParams; // changable parameters
DWORD dwSettableBaud; // allowable baud rates
WORD wSettableData; // allowable byte sizes
WORD wSettableStopParity; // stop bits/parity allowed
DWORD dwCurrentTxQueue; // Tx buffer size, in bytes
DWORD dwCurrentRxQueue; // Rx buffer size, in bytes
DWORD dwProvSpec1; // provider-specific data
DWORD dwProvSpec2; // provider-specific data

WCHAR wcProvChar[1]; // provider-specific data
} COMMPROP;


Members

wPacketLength

Specifies the size, in bytes, of the entire 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

Specifies the maximum allowable baud rate, in bits per second (bps). This member can be one of the following values:

Value Meaning
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

Specifies the specific communications provider type:

Value Meaning
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

Specifies a bitmask indicating the capabilities offered by the provider. This member can be one of the following values:

Value Meaning
PCF_16BITMODE Special 16-bit mode supported
PCF_DTRDSR DTR (data-terminal-ready)/DSR (data-set-ready) supported
PCF_INTTIMEOUTS Interval time-outs supported
PCF_PARITY_CHECK Parity checking supported
PCF_RLSD RLSD (receive-line-signal-detect) supported
PCF_RTSCTS RTS (request-to-send)/CTS (clear-to-send) supported
PCF_SETXCHAR Settable XON/XOFF supported
PCF_SPECIALCHARS Special character support provided
PCF_TOTALTIMEOUTS Total (elapsed) time-outs supported
PCF_XONXOFF XON/XOFF flow control supported


dwSettableParams

Specifies a bitmask indicating the communications parameter that can be changed. This member can be one of the following values:

Value Meaning
SP_BAUD Baud rate
SP_DATABITS Data bits
SP_HANDSHAKING Handshaking (flow control)
SP_PARITY Parity
SP_PARITY_CHECK Parity checking
SP_RLSD RLSD (receive-line-signal-detect)
SP_STOPBITS Stop bits


dwSettableBaud

Specifies a bitmask indicating the baud rates that can be used. For values, see the dwMaxBaud member.

wSettableData

Specifies a bitmask indicating the number of data bits that can be set. This member can be one of the following values:

Value Meaning
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

Specifies a bitmask indicating the stop bit and parity settings that can be selected. This member can be one of the following values:

Value Meaning
STOPBITS_10 1 stop bit
STOPBITS_15 1.5 stop bits
STOPBITS_20 2 stop bits
PARITY_NONE No parity
PARITY_ODD Odd parity
PARITY_EVEN Even parity
PARITY_MARK Mark parity
PARITY_SPACE Space parity


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 they have detailed information about the format of the data required by the provider.
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 they have detailed information about the format of the data required by the provider.

wcProvChar

Specifies provider-specific data. Applications should ignore this member unless they have detailed information about the format of the data required by the provider.



Remarks

The contents of the dwProvSpec1, dwProvSpec2, and wcProvChar members depend on the provider subtype (specified by the dwProvSubType member).
If the provider subtype is PST_MODEM, these members are used as follows:

Value Meaning
dwProvSpec1 Not used.
dwProvSpec2 Not used.
wcProvChar Contains a MODEMDEVCAPS structure.


See Also

GetCommProperties


Пригласи друзей и счет твоего мобильника всегда будет положительным!
Предыдущая статья
 
Сайт Народ.Ру Интернет
Следующая статья
Пригласи друзей и счет твоего мобильника всегда будет положительным!

COMMPROP



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

typedef struct _COMMPROP { // cmmp WORD wPacketLength; // размер пакета, в байтах WORD wPacketVersion; // версия пакета DWORD dwServiceMask; // услуги осуществляли DWORD dwReserved1; // зарезервировавшее DWORD dwMaxTxQueue; // max Tx bufsize, в байтах DWORD dwMaxRxQueue; // max Rx bufsize, в байтах DWORD dwMaxBaud; // показатель max бода, в бит в сек DWORD dwProvSubType; // специфический тип поставщика

DWORD dwProvCapabilities; // возможности поддерживали DWORD dwSettableParams; // changable параметры DWORD dwSettableBaud; // допустимый бод оценивает WORD wSettableData; // допустимый байт измеряет ТЕКСТОВЫЙ wSettableStopParity; // стоповые биты/четность допускали DWORD dwCurrentTxQueue; // Буферный размер Tx, в байтах DWORD dwCurrentRxQueue; // Буферный размер Rx, в байтах DWORD dwProvSpec1; // поставщик-специфические данные DWORD dwProvSpec2; // поставщик-специфические данные

WCHAR wcProvChar[1]; // поставщик-специфические данные } COMMPROP;


Участники

wPacketLength

Определяет размер, в байтах, целого пакета данных, независимо от суммы данных запрошенных.

wPacketVersion

Определяет версию структуры.

dwServiceMask

Определяет, что указание bitmask какие услуги осуществлены этим поставщиком. Величина SP_SERIALCOMM всегда определена для поставщиков связи, включая поставщиков модема.

dwReserved1

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

dwMaxTxQueue

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

dwMaxRxQueue

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

dwMaxBaud

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

Оцените Значение бит в сек BAUD_075 75 бит в сек BAUD_110 110 бит в сек BAUD_134_5 134.5 бит в сек BAUD_150 150 бит в сек BAUD_300 300 бит в сек BAUD_600 600 бит в сек BAUD_1200 1200 бит в сек BAUD_1800 1800 бит в сек BAUD_2400 2400 бит в сек BAUD_4800 4800 бит в сек BAUD_7200 7200 бит в сек BAUD_9600 9600 бит в сек BAUD_14400 14400 бит в сек BAUD_19200 19200 бит в сек BAUD_38400 38400 бит в сек BAUD_56K 56K бит в сек BAUD_57600 57600 бит в сек BAUD_115200 115200 бит в сек BAUD_128K 128K
Программируемый бод BAUD_USER оценивает доступный


dwProvSubType

Определяет тип поставщика специфической связи:

Оцените устройство ФАКСА Значения PST_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

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

Значение Величины
Специальный 16- битовый режим PCF_16BITMODE поддерживавший PCF_DTRDSR DTR (data-terminal-ready)/DSR (данные-были установлены-готовым) поддерживавшее задержки Интервала PCF_INTTIMEOUTS поддерживал Четность PCF_PARITY_CHECK, проверяющую предусмотренный PCF_RLSD RLSD (приемник-строка-сигнал-обнаруживает) поддерживавшее PCF_RTSCTS RTS (request-to-send)/CTS (очистка-посылает) поддерживавшее PCF_SETXCHAR Settable XON/XOFF поддерживавший Специальную поддержку символа PCF_SPECIALCHARS предусматривал Итог PCF_TOTALTIMEOUTS (пройденный), который задержки поддерживали управление потока PCF_XONXOFF XON/XOFF поддерживался


dwSettableParams

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

Оцените показатель Бода Значения SP_BAUD Данных SP_DATABITS кусает Рукопожатие SP_HANDSHAKING (управление потока) Четность SP_PARITY Parity SP_PARITY_CHECK, проверяющая SP_RLSD RLSD (приемник-строка-сигнал-обнаруживает) биты Стоп SP_STOPBITS


dwSettableBaud

Определяет bitmask указывая, что бод оценивает, что может быть использовано. Для величин, смотри элемент dwMaxBaud.

wSettableData

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

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


wSettableStopParity

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

Оцените Значение STOPBITS_10 1 стоповых битовых стоповых битов STOPBITS_15 1.5 стоп STOPBITS_20 2 кусает No четность 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


Вверх Version 1.3, Oct 26 2010 © 2007, 2010, mrhx Вверх
 mrhx software  Русский перевод OpenGL  Русский перевод Win32 API
 
Используются технологии uCoz