Compartilhar via


Função GetCommMask (winbase.h)

Recupera o valor da máscara de evento para um dispositivo de comunicação especificado.

Sintaxe

BOOL GetCommMask(
  [in]  HANDLE  hFile,
  [out] LPDWORD lpEvtMask
);

Parâmetros

[in] hFile

Um identificador para o dispositivo de comunicações. A função CreateFile retorna esse identificador.

[out] lpEvtMask

Um ponteiro para a variável que recebe uma máscara de eventos que estão habilitados no momento. Esse parâmetro pode usar um dos valores a seguir.

Valor Significado
EV_BREAK
0x0040
Uma quebra na entrada foi detectada.
EV_CTS
0x0008
O sinal CTS (limpar para enviar) alterou o estado.
EV_DSR
0x0010
O sinal DSR (pronto para conjunto de dados) alterou o estado.
EV_ERR
0x0080
Ocorreu um erro de status de linha. Os erros de status de linha são CE_FRAME, CE_OVERRUN e CE_RXPARITY.
EV_EVENT1
0x0800
Ocorreu um evento do primeiro tipo específico do provedor.
EV_EVENT2
0x1000
Ocorreu um evento do segundo tipo específico do provedor.
EV_PERR
0x0200
Ocorreu um erro de impressora.
EV_RING
0x0100
Um indicador de anel foi detectado.
EV_RLSD
0x0020
O sinal RLSD (receive-line-signal-detect) alterou o estado.
EV_RX80FULL
0x0400
O buffer de recebimento está 80% cheio.
EV_RXCHAR
0x0001
Um caractere foi recebido e colocado no buffer de entrada.
EV_RXFLAG
0x0002
O caractere de evento foi recebido e colocado no buffer de entrada. O caractere de evento é especificado na estrutura DCB do dispositivo, que é aplicada a uma porta serial usando a função SetCommState .
EV_TXEMPTY
0x0004
O último caractere no buffer de saída foi enviado.

Valor retornado

Se a função for bem-sucedida, o valor retornado será diferente de zero.

Se a função falhar, o valor retornado será zero. Para obter informações de erro estendidas, chame GetLastError.

Comentários

A função GetCommMask usa uma variável de máscara para indicar o conjunto de eventos que podem ser monitorados para um recurso de comunicação específico. Um identificador para o recurso de comunicações pode ser especificado em uma chamada para a função WaitCommEvent , que aguarda a ocorrência de um dos eventos. Para modificar a máscara de evento de um recurso de comunicação, use a função SetCommMask .

Requisitos

Requisito Valor
Cliente mínimo com suporte Windows XP [aplicativos da área de trabalho | aplicativos UWP]
Servidor mínimo com suporte Windows Server 2003 [aplicativos da área de trabalho | Aplicativos UWP]
Plataforma de Destino Windows
Cabeçalho winbase.h (inclua Windows.h)
Biblioteca Kernel32.lib
DLL Kernel32.dll

Confira também

Funções de comunicação

Recursos de comunicação

CreateFile

DCB

SetCommMask

WaitCommEvent