Funzione SetCommMask (winbase.h)

Articolo
03/08/2023

Specifica un set di eventi da monitorare per un dispositivo di comunicazione.

Sintassi

BOOL SetCommMask(
  [in] HANDLE hFile,
  [in] DWORD  dwEvtMask
);

Parametri

[in] hFile

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

[in] dwEvtMask

Eventi da abilitare. Il valore zero disabilita tutti gli eventi. Questo parametro può essere uno o più dei valori seguenti.

Valore	Significato
EV_BREAK 0x0040	È stata rilevata un'interruzione nell'input.
EV_CTS 0x0008	Lo stato del segnale CTS (clear-to-send) è cambiato.
EV_DSR 0x0010	Lo stato del segnale DSR (data-set-ready) è stato modificato.
EV_ERR 0x0080	Si è verificato un errore di stato della riga. Gli errori di stato riga sono CE_FRAME, CE_OVERRUN e CE_RXPARITY.
EV_RING 0x0100	È stato rilevato un indicatore sonoro.
EV_RLSD 0x0020	Lo stato del segnale RLSD (receive-line-signal-detect) è cambiato.
EV_RXCHAR 0x0001	È stato ricevuto un carattere ed è stato collocato nel buffer di input.
EV_RXFLAG 0x0002	Il carattere dell'evento è stato ricevuto e inserito nel buffer di input. Il carattere di evento viene specificato nella struttura DCB del dispositivo, che viene applicata a una porta seriale usando la funzione SetCommState .
EV_TXEMPTY 0x0004	Ultimo carattere nel buffer di output 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 SetCommMask specifica 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 ottenere la maschera evento corrente di una risorsa di comunicazione, usare la funzione GetCommMask .

Esempio

Per un esempio, vedere Monitoraggio degli eventi di comunicazione.

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