Condividi tramite


Funzione GetCommMask (winbase.h)

Recupera il valore della maschera eventi per un dispositivo di comunicazione specificato.

Sintassi

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

Parametri

[in] hFile

Handle per il dispositivo di comunicazione. La funzione CreateFile restituisce questo handle.

[out] lpEvtMask

Puntatore alla variabile che riceve una maschera di eventi attualmente abilitati. Questo parametro può essere uno o più dei valori seguenti.

Valore Significato
EV_BREAK
0x0040
È stata rilevata un'interruzione nell'input.
EV_CTS
0x0008
Il segnale CTS (clear-to-send) ha modificato lo stato.
EV_DSR
0x0010
Lo stato del segnale DSR (data-set-ready) è cambiato.
EV_ERR
0x0080
Si è verificato un errore di stato della riga. Gli errori di stato della riga sono CE_FRAME, CE_OVERRUN e CE_RXPARITY.
EV_EVENT1
0x0800
Si è verificato un evento del primo tipo specifico del provider.
EV_EVENT2
0x1000
Si è verificato un evento del secondo tipo specifico del provider.
EV_PERR
0x0200
Si è verificato un errore della stampante.
EV_RING
0x0100
È stato rilevato un indicatore sonoro.
EV_RLSD
0x0020
Stato modificato del segnale RLSD (receive-line-signal-detect).
EV_RX80FULL
0x0400
Il buffer di ricezione è pieno del 80%.
EV_RXCHAR
0x0001
È stato ricevuto un carattere ed è stato collocato nel buffer di input.
EV_RXFLAG
0x0002
Il carattere di evento è stato ricevuto e inserito nel buffer di input. Il carattere di evento viene specificato nella struttura DCB del dispositivo, applicata a una porta seriale usando la funzione SetCommState .
EV_TXEMPTY
0x0004
L'ultimo carattere nel buffer di output è stato inviato.

Valore restituito

Se la funzione ha esito positivo, il valore restituito è diverso da zero.

Se la funzione ha esito negativo, il valore restituito è zero. Per informazioni dettagliate sull'errore, chiamare GetLastError.

Commenti

La funzione GetCommMask usa una variabile mask per indicare il set di eventi che possono essere monitorati per una determinata risorsa di comunicazione. Un handle per la risorsa di comunicazione può essere specificato in una chiamata alla funzione WaitCommEvent , che attende che si verifichi uno degli eventi. Per modificare la maschera evento di una risorsa di comunicazione, usare la funzione SetCommMask .

Requisiti

Requisito Valore
Client minimo supportato Windows XP [app desktop | App UWP]
Server minimo supportato Windows Server 2003 [app desktop | App UWP]
Piattaforma di destinazione Windows
Intestazione winbase.h (include Windows.h)
Libreria Kernel32.lib
DLL Kernel32.dll

Vedere anche

Funzioni di comunicazione

Risorse di comunicazione

CreateFile

DCB

SetCommMask

WaitCommEvent