GetCommMask

9/8/2008

Essa função recupera o valor máscara evento para um dispositivo de comunicação especificada.

Syntax

BOOL GetCommMask(
  HANDLE hFile,
  LPDWORD lpEvtMask
);

Parameters

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

• lpEvtMask
  [out] Ponteiro longo para a 32-bit variável a ser preenchido com uma máscara de eventos atualmente habilitado. A seguinte tabela mostra os valores possíveis.

  Valor	Descrição
  EV_BREAK	Um interromper foi detectado na entrada.
  EV_CTS	O CTS (Clear To Send) sinal estado alterado.
  EV_DSR	O sinal DSR (conjunto de dados pronto) 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	O sinal RLSD (de recebimento de linha de sinal detectar) 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 estendido dados de erro, chamar a função GetLastError.

Remarks

O GetCommMask função usa um 32-variável bitmask para indicar 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 evento para ocorrer.

Para modificar a máscara evento de um recurso de comunicação, use a função SetCommMask.

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
SetCommMask
SetCommState
WaitCommEvent
DCB

Other Resources

CreateFile