winbase.h


SetCommMask

Especifica un grupo de eventos para ser monitorizados para un dispositivo de comunicaciones.

Sintaxis

BOOL SetCommMask(
    HANDLE hCommDev,  // manipulador de dispositivo de comunicaciones
    DWORD fdwEvtMask  // máscara que identifica los eventos activados
   );

Parámetros:

hCommDev: identifica el dispositivo de comunicaciones. Este manipulador es devuelto por la función CreateFile.

fdwEvtMask: especifica los eventos a activar. Un valor de cero desactiva todos los eventos. Este parámetro puede ser una combinación de los siguientes valores:

Valor Significado
EV_BREAK Se ha detectado un corte en la entrada.
EV_CTS Cambio de estado en la señal CTS (clear-to-send: preparado para enviar).
EV_DSR Cambio de estado en la señal DSR (data-set-ready: datos preparados).
EV_ERR Error en línea de estatus. Este error puede ser CE_FRAME, CE_OVERRUN y CE_RXPARITY.
EV_RING Se ha recibido un indicador de llamada.
EV_RLSD Cambio de estado en señal RLSD (receive-line-signal-detect: detección de señal en línea de entrada).
EV_RXCHAR Se ha recibido un carácter y se ha colocado en el buffer de entrada.
EV_RXFLAG El carácter de evento se ha recibido y colocado en el buffer de entrada. El carácter de evento se especifica en la estructura DCB del dispositivo, que es aplicada al puerto serie usando la función SetCommState.
EV_TXEMPTY El último carácter del buffer de salida ha sido enviado.

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

La función SetCommMask especifica el conjunto de eventos que pueden monitorizarse para un recurso de comunicaciones en particular. Se puede especificar un manipulador de recurso de comunicaciones en una llamada a la función WaitCommEvent, que esperará a que ocurra uno de los eventos. Para obtener la máscara de eventos actual para un recurso de comunicaciones, usar la función GetCommMask.

Si se llama a SetCommMask para un recurso de comunicaciones mientras una espera superpuesta (overlapped) está pendiente para ese recurso, WaitCommEvent devolverá un error.