• Biblioteca = kernel32.lib • Cabecera = winbase.h • Unicode = No • Plataforma = Nada•
Especifica un grupo de eventos para ser monitorizados para un dispositivo de comunicaciones.
BOOL SetCommMask( HANDLE hCommDev, // manipulador de dispositivo de comunicaciones DWORD fdwEvtMask // máscara que identifica los eventos activados );
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. |
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.
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.
© Marzo de 2002, Salvador Pozo Coronado, salvador@conclase.net Generada en 0.6 segs