winbase.h


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.