Estrutura COMMPROP (winbase.h)

Contém informações sobre um driver de comunicações.

Sintaxe

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;

Membros

wPacketLength

O tamanho de todo o pacote de dados, independentemente da quantidade de dados solicitados, em bytes.

wPacketVersion

A versão da estrutura.

dwServiceMask

Uma máscara de bits que indica quais serviços são implementados por esse provedor. O valor SP_SERIALCOMM é sempre especificado para provedores de comunicações, incluindo provedores de modem.

dwReserved1

Reservado; não use.

dwMaxTxQueue

O tamanho máximo do buffer de saída interno do driver, em bytes. Um valor zero indica que nenhum valor máximo é imposto pelo provedor serial.

dwMaxRxQueue

O tamanho máximo do buffer de entrada interno do driver, em bytes. Um valor zero indica que nenhum valor máximo é imposto pelo provedor serial.

dwMaxBaud

A taxa máxima de baud permitida, em bits por segundo (bps). Esse membro pode ser um dos valores a seguir.

dwProvSubType

O tipo de provedor de comunicações.

dwProvCapabilities

Uma máscara de bits que indica os recursos oferecidos pelo provedor. Esse membro pode ser uma combinação dos valores a seguir.

dwSettableParams

Uma máscara de bits que indica os parâmetros de comunicação que podem ser alterados. Esse membro pode ser uma combinação dos valores a seguir.

dwSettableBaud

As taxas de baud que podem ser usadas. Para obter valores, consulte o membro dwMaxBaud .

wSettableData

Uma máscara de bits que indica o número de bits de dados que podem ser definidos. Esse membro pode ser uma combinação dos valores a seguir.

wSettableStopParity

Uma máscara de bits que indica as configurações de paridade e bit de parada que podem ser selecionadas. Esse membro pode ser uma combinação dos valores a seguir.

dwCurrentTxQueue

O tamanho do buffer de saída interno do driver, em bytes. Um valor zero indica que o valor não está disponível.

dwCurrentRxQueue

O tamanho do buffer de entrada interno do driver, em bytes. Um valor zero indica que o valor não está disponível.

dwProvSpec1

Todos os dados específicos do provedor. Os aplicativos devem ignorar esse membro, a menos que tenham informações detalhadas sobre o formato dos dados exigidos pelo provedor.

Defina esse membro como COMMPROP_INITIALIZED antes de chamar a função GetCommProperties para indicar que o membro wPacketLength já é válido.

dwProvSpec2

Todos os dados específicos do provedor. Os aplicativos devem ignorar esse membro, a menos que tenham informações detalhadas sobre o formato dos dados exigidos pelo provedor.

wcProvChar[1]

Todos os dados específicos do provedor. Os aplicativos devem ignorar esse membro, a menos que tenham informações detalhadas sobre o formato dos dados exigidos pelo provedor.

Comentários

O conteúdo dos membros dwProvSpec1, dwProvSpec2 e wcProvChar depende do subtipo do provedor (especificado pelo membro dwProvSubType ).

Se o subtipo do provedor for PST_MODEM, esses membros serão usados da seguinte maneira.

Requisitos

Confira também

GetCommProperties