Función SetCommState (winbase.h)
Configura un dispositivo de comunicaciones según las especificaciones de un bloque de control de dispositivo (una estructura DCB ). La función reinicializa todas las configuraciones de hardware y control, pero no vacía las colas de entrada o salida.
Sintaxis
BOOL SetCommState(
[in] HANDLE hFile,
[in] LPDCB lpDCB
);
Parámetros
[in] hFile
Identificador del dispositivo de comunicaciones. La función CreateFile devuelve este identificador.
[in] lpDCB
Puntero a una estructura DCB que contiene la información de configuración del dispositivo de comunicaciones especificado.
Valor devuelto
Si la función se realiza correctamente, el valor devuelto es distinto de cero.
Si la función no se realiza correctamente, el valor devuelto es cero. Para obtener información de error extendida, llame a GetLastError.
Comentarios
La función SetCommState usa una estructura DCB para especificar la configuración deseada. La función GetCommState devuelve la configuración actual.
Para establecer solo algunos miembros de la estructura DCB , debe modificar una estructura DCB rellenada por una llamada a GetCommState. Esto garantiza que los demás miembros de la estructura DCB tengan los valores adecuados.
Se produce un error en la función SetCommState si el miembro XonChar de la estructura DCB es igual al miembro XoffChar .
Cuando se usa SetCommState para configurar la versión 8250, se aplican las restricciones siguientes a los valores de los miembros ByteSize y StopBits de la estructura DCB:
El número de bits de datos debe ser de 5 a 8 bits.
Ejemplos
Para obtener un ejemplo, consulte Configuración de un recurso de comunicaciones.
Requisitos
| Requisito | Value |
|---|---|
| Cliente mínimo compatible | Windows XP [aplicaciones de escritorio | aplicaciones para UWP] |
| Servidor mínimo compatible | Windows Server 2003 [aplicaciones de escritorio | aplicaciones para UWP] |
| Plataforma de destino | Windows |
| Encabezado | winbase.h (incluye Windows.h) |
| Library | Kernel32.lib |
| Archivo DLL | Kernel32.dll |