GetCommMask
Recupera el valor de la máscara de eventos para el dispositivo de comunicaciones especificado.
Sintaxis
BOOL GetCommMask(
HANDLE hFile, // manipulador de dispositivo de comunicaciones
LPDWORD lpEvtMask // dirección de la variable para recibir la máscara de eventos
);
Parámetros:
hFile: identifica el dispositivo de comunicaciones. Este manipulador es devuelto por la función CreateFile.
lpEvtMask: puntero a una variable de 32 bits que se llenará con la máscara de eventos que están activados actualmente. Este parámetro puede tomar uno o más 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_EVENT1 | Ha ocurrido un evento del primer tipo especificado por el proveedor. |
| EV_EVENT2 | Ha ocurrido un evento del segundo tipo especificado por el proveedor. |
| 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_RX80FULL | El buffer de entrada está lleno al 80%. |
| 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 GetCommMask usa una variable de máscara de 32 bits para indicar el conjunto de eventos a monitorizar para un recurso de comunicaciones en particular. Se puede especificar un manipulador de un recurso de comunicaciones en la llamada a la función WaitCommEvent, que esperará a que ocurra uno de los eventos. Para modificar la máscara de eventos para un recurso de comunicaciones, usar la función SetCommMask.