WaitCommEvent
.gif "A checkmark indicates that the information in this topic is relevant for this platform, and that any API listed is also supported on this platform.")
.gif "A checkmark indicates that the information in this topic is relevant for this platform, and that any API listed is also supported on this platform.")
9/8/2008
Essa função aguarda um evento para ocorrer para um dispositivo de comunicação especificada.
O conjunto de eventos monitorados por WaitCommEvent está contido em máscara de evento associado com identificador de dispositivo.
Syntax
BOOL WaitCommEvent(
HANDLE hFile,
LPDWORD lpEvtMask,
LPOVERLAPPED lpOverlapped
);
Parameters
- hFile
[no] Identificador para o dispositivo de comunicação, retornado pela função a CreateFile.
lpEvtMask
[out] Ponteiro longo para um 32-bit variável que recebe uma máscara indicando os eventos que ocorreram. Se um erro ocorrer, o valor é zero. Caso contrário, ele é um ou mais dos valores a seguinte tabela.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_POWER
Evento de energia, que é gerado sempre que o dispositivo está ligado.
Esse valor é específico para Windows Embedded CE.
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.
- lpOverlapped
[no] Ignorada; Definir como NULL.
Return Value
Nonzero indica sucesso. Zero indica falha. Para obter informações de erro estendidas, chamar a função GetLastError.
Remarks
O WaitCommEvent função monitora um conjunto de eventos para um recurso de comunicação especificada. Para definir e consulta o atual máscara evento de um recurso de comunicação, use as funções SetCommMask e GetCommMask. Quando um evento de comunicações que é definido pelo SetCommMask Ocorre, WaitCommEvent Retorna.
Apenas um WaitCommEvent Pode ser usado para cada aberto identificador porta COM. Isso significa que se você tiver três segmentos no seu aplicativo e cada segmento precisa aguardar em um evento de comunicação específicas, cada segmento precisa para aberto a porta COM e, em seguida, use o identificador atribuído a porta para seus respectivos WaitCommEvent Chamadas.
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
GetCommMask
SetCommMask
SetCommState
DCB