Funzione GetCommMask (winbase.h)

Articolo
08/27/2023

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