Estructura COMMPROP (winbase.h)
Contiene información sobre un controlador de comunicaciones.
Sintaxis
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;
Miembros
wPacketLength
Tamaño de todo el paquete de datos, independientemente de la cantidad de datos solicitada, en bytes.
wPacketVersion
Versión de la estructura.
dwServiceMask
Máscara de bits que indica qué servicios implementa este proveedor. El valor de SP_SERIALCOMM siempre se especifica para los proveedores de comunicaciones, incluidos los proveedores de módems.
dwReserved1
Reservado; no usar.
dwMaxTxQueue
Tamaño máximo del búfer de salida interno del controlador, en bytes. Un valor de cero indica que el proveedor de serie no impone ningún valor máximo.
dwMaxRxQueue
Tamaño máximo del búfer de entrada interno del controlador, en bytes. Un valor de cero indica que el proveedor de serie no impone ningún valor máximo.
dwMaxBaud
Velocidad máxima de baudios permitida, en bits por segundo (bps). Este miembro puede ser uno de los valores siguientes.
dwProvSubType
Tipo de proveedor de comunicaciones.
dwProvCapabilities
Máscara de bits que indica las funcionalidades que ofrece el proveedor. Este miembro puede ser una combinación de los valores siguientes.
dwSettableParams
Máscara de bits que indica los parámetros de comunicaciones que se pueden cambiar. Este miembro puede ser una combinación de los valores siguientes.
dwSettableBaud
Velocidades de baudios que se pueden usar. Para obtener valores, consulte el miembro dwMaxBaud .
wSettableData
Máscara de bits que indica el número de bits de datos que se pueden establecer. Este miembro puede ser una combinación de los valores siguientes.
wSettableStopParity
Máscara de bits que indica la configuración de paridad y bits de detención que se puede seleccionar. Este miembro puede ser una combinación de los valores siguientes.
dwCurrentTxQueue
Tamaño del búfer de salida interno del controlador, en bytes. Un valor de cero indica que el valor no está disponible.
dwCurrentRxQueue
Tamaño del búfer de entrada interno del controlador, en bytes. Un valor de cero indica que el valor no está disponible.
dwProvSpec1
Cualquier dato específico del proveedor. Las aplicaciones deben omitir este miembro a menos que tengan información detallada sobre el formato de los datos requeridos por el proveedor.
Establezca este miembro en COMMPROP_INITIALIZED antes de llamar a la función GetCommProperties para indicar que el miembro wPacketLength ya es válido.
dwProvSpec2
Cualquier dato específico del proveedor. Las aplicaciones deben omitir este miembro a menos que tengan información detallada sobre el formato de los datos requeridos por el proveedor.
wcProvChar[1]
Cualquier dato específico del proveedor. Las aplicaciones deben omitir este miembro a menos que tengan información detallada sobre el formato de los datos requeridos por el proveedor.
Comentarios
El contenido de los miembros dwProvSpec1, dwProvSpec2 y wcProvChar dependen del subtipo de proveedor (especificado por el miembro dwProvSubType ).
Si el subtipo del proveedor es PST_MODEM, estos miembros se usan de la siguiente manera.
| Value | Significado |
|---|---|
| dwProvSpec1 | No se usa. |
| dwProvSpec2 | No se usa. |
| wcProvChar | Contiene una estructura MODEMDEVCAPS . |
Requisitos
| Cliente mínimo compatible | Windows XP |
| Servidor mínimo compatible | Windows Server 2003 |
| Encabezado | winbase.h (incluya Windows.h) |