Compartir a través de


Función GetCommMask (winbase.h)

Recupera el valor de la máscara de eventos para un dispositivo de comunicaciones especificado.

Sintaxis

BOOL GetCommMask(
  [in]  HANDLE  hFile,
  [out] LPDWORD lpEvtMask
);

Parámetros

[in] hFile

Identificador del dispositivo de comunicaciones. La función CreateFile devuelve este identificador.

[out] lpEvtMask

Puntero a la variable que recibe una máscara de eventos que están habilitados actualmente. Este parámetro puede ser uno o más de los siguientes valores.

Valor Significado
EV_BREAK
0x0040
Se ha detectado una interrupción en la entrada.
EV_CTS
0x0008
El estado de la señal CTS (despejado a envío).
EV_DSR
0x0010
El estado de la señal DSR (listo para conjuntos de datos) ha cambiado.
EV_ERR
0x0080
Error de estado de línea. Los errores de estado de línea son CE_FRAME, CE_OVERRUN y CE_RXPARITY.
EV_EVENT1
0x0800
Se produjo un evento del primer tipo específico del proveedor.
EV_EVENT2
0x1000
Se produjo un evento del segundo tipo específico del proveedor.
EV_PERR
0x0200
Error de impresora.
EV_RING
0x0100
Se ha detectado un indicador de llamada.
EV_RLSD
0x0020
El estado de la señal RLSD (receive-line-signal-detect).
EV_RX80FULL
0x0400
El búfer de recepción está lleno del 80 %.
EV_RXCHAR
0x0001
Se ha recibido y colocado un carácter en el búfer de entrada.
EV_RXFLAG
0x0002
Se recibió el carácter de evento y se colocó en el búfer de entrada. El carácter de evento se especifica en la estructura DCB del dispositivo, que se aplica a un puerto serie mediante la función SetCommState .
EV_TXEMPTY
0x0004
Se envió el último carácter del búfer de salida.

Valor devuelto

Si la función se realiza correctamente, el valor devuelto es distinto de cero.

Si la función no se realiza correctamente, el valor devuelto es cero. Para obtener información de error extendida, llame a GetLastError.

Comentarios

La función GetCommMask usa una variable mask para indicar el conjunto de eventos que se pueden supervisar para un recurso de comunicaciones determinado. Se puede especificar un identificador para el recurso de comunicaciones en una llamada a la función WaitCommEvent , que espera a que se produzca uno de los eventos. Para modificar la máscara de eventos de un recurso de comunicaciones, use la función SetCommMask .

Requisitos

Requisito Value
Cliente mínimo compatible Windows XP [aplicaciones de escritorio | aplicaciones para UWP]
Servidor mínimo compatible Windows Server 2003 [aplicaciones de escritorio | aplicaciones para UWP]
Plataforma de destino Windows
Encabezado winbase.h (incluya Windows.h)
Library Kernel32.lib
Archivo DLL Kernel32.dll

Vea también

Funciones de comunicaciones

Recursos de comunicaciones

CreateFile

DCB

SetCommMask

WaitCommEvent