Структура 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
Максимально допустимая скорость передачи данных в битах в секунду (б/с). Этот элемент может быть одним из следующих значений.
dwProvSubType
Тип поставщика связи.
dwProvCapabilities
Битовая маска, указывающая возможности, предлагаемые поставщиком. Этот элемент может быть сочетанием следующих значений.
dwSettableParams
Битовая маска, указывающая параметры связи, которые можно изменить. Этот элемент может быть сочетанием следующих значений.
dwSettableBaud
Тарифы baud, которые можно использовать. Значения см. в элементе dwMaxBaud .
wSettableData
Битовая маска, указывающая количество битов данных, которые можно задать. Этот элемент может быть сочетанием следующих значений.
wSettableStopParity
Битовая маска, указывающая параметры стоп-бита и четности, которые можно выбрать. Этот элемент может быть сочетанием следующих значений.
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) |