Función GetCommMask (winbase.h)

Artículo
08/27/2023

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