Compartilhar via


Estrutura COMMCONFIG (winbase.h)

Contém informações sobre o estado de configuração de um dispositivo de comunicação.

Sintaxe

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

Membros

dwSize

O tamanho da estrutura em bytes. O chamador deve definir esse membro como sizeof(COMMCONFIG).

wVersion

O número de versão da estrutura. Esse parâmetro pode ser 1. A versão da estrutura específica do provedor deve ser incluída no membro wcProviderData .

wReserved

Reservado; não use.

dcb

A estrutura dcb (bloco de controle de dispositivo) para dispositivos serial RS-232. Uma estrutura DCB está sempre presente independentemente do subtipo do driver de porta especificado na estrutura COMMPROP do dispositivo.

dwProviderSubType

O tipo de provedor de comunicações e, portanto, o formato dos dados específicos do provedor. Para obter uma lista de tipos de provedor de comunicações, consulte a descrição da estrutura COMMPROP .

dwProviderOffset

O deslocamento dos dados específicos do provedor em relação ao início da estrutura, em bytes. Esse membro será zero se não houver dados específicos do provedor.

dwProviderSize

O tamanho dos dados específicos do provedor, em bytes.

wcProviderData[1]

Dados opcionais específicos do provedor. Esse membro pode ter qualquer tamanho ou pode ser omitido. Como a estrutura COMMCONFIG pode ser expandida no futuro, os aplicativos devem usar o membro dwProviderOffset para determinar a localização desse membro.

Comentários

Se o subtipo do provedor for PST_RS232 ou PST_PARALLELPORT, o membro wcProviderData será omitido. Se o subtipo do provedor for PST_MODEM, o membro wcProviderData conterá uma estrutura MODEMSETTINGS .

Requisitos

Requisito Valor
Cliente mínimo com suporte Windows XP
Servidor mínimo com suporte Windows Server 2003
Cabeçalho winbase.h (inclua Windows.h)

Confira também

COMMPROP

DCB

GetCommProperties

MODEMSETTINGS