WinNT Sí
Win95 Sí
Win32s No
• Biblioteca = kernel32.lib • Cabecera = winbase.h
• Unicode = No
• Plataforma = Nada•

SetCommMask

^

Especifica un grupo de eventos para ser monitorizados para un dispositivo de comunicaciones.

Sintaxis

^
BOOL SetCommMask(
    HANDLE hCommDev,  // manipulador de dispositivo de comunicaciones
    DWORD fdwEvtMask  // máscara que identifica los eventos activados
   );

Parámetros:

^

hCommDev: identifica el dispositivo de comunicaciones. Este manipulador es devuelto por la función CreateFile.

fdwEvtMask: especifica los eventos a activar. Un valor de cero desactiva todos los eventos. Este parámetro puede ser una combinación 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_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_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 SetCommMask especifica el conjunto de eventos que pueden monitorizarse para un recurso de comunicaciones en particular. Se puede especificar un manipulador de recurso de comunicaciones en una llamada a la función WaitCommEvent, que esperará a que ocurra uno de los eventos. Para obtener la máscara de eventos actual para un recurso de comunicaciones, usar la función GetCommMask.

Si se llama a SetCommMask para un recurso de comunicaciones mientras una espera superpuesta (overlapped) está pendiente para ese recurso, WaitCommEvent devolverá un error.


suministrado por FreeFind
Valid HTML 4.0! Valid CSS!