Función SetCommState (winbase.h)

Artículo
03/13/2024

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