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.
| Valor | Significado |
|---|---|
| dwProvSpec1 | Não usado. |
| dwProvSpec2 | Não usado. |
| wcProvChar | Contém uma estrutura MODEMDEVCAPS . |
Requisitos
| Cliente mínimo com suporte | Windows XP |
| Servidor mínimo com suporte | Windows Server 2003 |
| Cabeçalho | winbase.h (incluir Windows.h) |