Función GetCommMask (winbase.h)
Recupera el valor de la máscara de eventos para un dispositivo de comunicaciones especificado.
BOOL GetCommMask(
[in] HANDLE hFile,
[out] LPDWORD lpEvtMask
);
[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 |
---|---|
|
Se ha detectado una interrupción en la entrada. |
|
El estado de la señal CTS (despejado a envío). |
|
El estado de la señal DSR (listo para conjuntos de datos) ha cambiado. |
|
Error de estado de línea. Los errores de estado de línea son CE_FRAME, CE_OVERRUN y CE_RXPARITY. |
|
Se produjo un evento del primer tipo específico del proveedor. |
|
Se produjo un evento del segundo tipo específico del proveedor. |
|
Error de impresora. |
|
Se ha detectado un indicador de llamada. |
|
El estado de la señal RLSD (receive-line-signal-detect). |
|
El búfer de recepción está lleno del 80 %. |
|
Se ha recibido y colocado un carácter en el búfer de entrada. |
|
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 . |
|
Se envió el último carácter del búfer de salida. |
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.
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 .
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 |