SetCommMask

9/8/2008

Essa função especifica um conjunto de eventos a ser monitorado para um dispositivo de comunicação.

Syntax

BOOL SetCommMask(
  HANDLE hFile,
  DWORD dwEvtMask
);

Parameters

• hFile
  [no] Identificador para o dispositivo de comunicação, retornado pela função a CreateFile.

• dwEvtMask
  [no] Especifica os eventos a ser habilitado e imediatamente sinaliza qualquer segmento espera sobre a função WaitCommEvent. Um valor de zero desativa todos os eventos.

  A seguinte tabela mostra valores possíveis para esse parâmetro.

  Valor	Descrição
  EV_BREAK	Um interromper foi detectado na entrada.
  EV_CTS	O sinal (CTS) criptografado para-Enviar estado alterado.
  EV_DSR	O sinal de dados-conjunto-pronto (DSR) alterado estado.
  EV_ERR	Uma linha-Erro status. Linha-status erros são CE_FRAME, CE_OVERRUN e CE_RXPARITY.
  EV_RING	Um indicador de Toque detectado.
  EV_RLSD	A recepção-linha - sinal - detecção (RLSD) sinal alterado estado.
  EV_RXCHAR	Um caractere foi recebida e colocada na buffer de entrada.
  EV_RXFLAG	O caractere evento foi recebida e colocada na buffer de entrada. O caractere evento é especificado na estrutura DCB do dispositivo, que é aplicada a um porta serial usando a função SetCommState.
  EV_TXEMPTY	O último caractere na reserva de saída foi enviada.

Return Value

Nonzero indica sucesso. Zero indica falha. Para obter informações de erro estendidas, chamar a função GetLastError.

Remarks

O SetCommState função especifica o conjunto de eventos que podem ser monitorados para um recurso de comunicação particular.

Um identificador para o recurso de comunicação pode ser especificado em um chamar para a função WaitCommEvent, que aguarda um dos eventos para ocorrer.

Para obter o atual máscara evento de um recurso de comunicação, use a função GetCommMask.

Requirements

Header	winbase.h
Library	Serdev.lib
Windows Embedded CE	Windows CE 1.0 and later
Windows Mobile	Windows Mobile Version 5.0 and later

See Also

Reference

Serial Communications Functions
DCB
GetCommMask
SetCommState
WaitCommEvent

Other Resources

CreateFile