winbase.h


SetCommState

Configura un dispositivo de comunicaciones de acuerdo con las especificaciones de un bloque de control de dispositivo (una estructura DCB). La función reinicia todo el hardware y valores de control, pero no vacía las colas de entrada o salida.

Sintaxis

BOOL SetCommState(
    HANDLE hCommDev,  // manipulador de dispositivo de comunicaciones
    LPDCB lpdcb       // dirección de la estructura de bloque de control de dispositivo
   );

Parámetros:

hCommDev: identifica el dispositivo de comunicaciones. La función CreateFile devuelve este manipulador.

lpDCB: puntero a estructura DCB que contiene la información para el dispositivo especificado.

Valor de retorno

Si la función tiene éxito, el valor de retorno es TRUE.

Si la función falla, el valor de retorno es FALSE. Para obtener mayor información sobre el error, llamar a GetLastError.

Observaciones

Esta función usa una estructura DCB para especificar la configuración deseada. La función GetCommState devuelve la configuración actual.

Para modificar sólo algunos miembros de la estructura DCB, se puede modificar la estructura DCB que se a llenado mediante una llamada a GetCommState. Esto asegura que el resto de los miembros de la estructura DCB contienen los valores adecuados.

La función falla si el miembro XonChar de la estructura DCB es igual que el miembro XoffChar.

Cuando una esta función se usa para configurar el 8250, se deben aplicar las siguientes restricciones a los valores especificados por los miembros ByteSize StopBits de la estructura DCB:

  • El número de bits de datos debe estar ente 5 y 8.
  • El uso de 5 bits de datos con 2 bits de parada es una combinación no válida, así como 6, 7 u 8 bits de datos con 1.5 bits de parada.