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

Содержит сведения о состоянии конфигурации устройства связи.

Синтаксис

typedef struct _COMMCONFIG {
  DWORD dwSize;
  WORD  wVersion;
  WORD  wReserved;
  DCB   dcb;
  DWORD dwProviderSubType;
  DWORD dwProviderOffset;
  DWORD dwProviderSize;
  WCHAR wcProviderData[1];
} COMMCONFIG, *LPCOMMCONFIG;

Члены

dwSize

Размер структуры в байтах. Вызывающий объект должен присвоить этому члену значение sizeof(COMMCONFIG).

wVersion

Номер версии структуры. Этот параметр может иметь значение 1. Версия структуры, зависящего от поставщика, должна быть включена в член wcProviderData .

wReserved

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

dcb

Структура блока управления устройствами (DCB) для последовательных устройств RS-232. Структура DCB всегда присутствует независимо от подтипа драйвера порта, указанного в структуре COMMPROP устройства.

dwProviderSubType

Тип поставщика связи и, следовательно, формат данных, относящихся к поставщику. Список типов поставщиков связи см. в описании структуры COMMPROP .

dwProviderOffset

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

dwProviderSize

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

wcProviderData[1]

Необязательные данные поставщика. Этот элемент может иметь любой размер или может быть опущен. Так как структура COMMCONFIG может быть расширена в будущем, приложения должны использовать элемент dwProviderOffset для определения расположения этого элемента.

Комментарии

Если подтип поставщика — PST_RS232 или PST_PARALLELPORT, то элемент wcProviderData опущен. Если подтип поставщика — PST_MODEM, член wcProviderData содержит структуру MODEMSETTINGS .

Требования

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

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

COMMPROP

DCB

GetCommProperties

МОДЕМНАСТРОЙКИ