Funzione SetCommMask (winbase.h)
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 |
|---|---|
|
È stata rilevata un'interruzione nell'input. |
|
Lo stato del segnale CTS (clear-to-send) è cambiato. |
|
Lo stato del segnale DSR (data-set-ready) è stato modificato. |
|
Si è verificato un errore di stato della riga. Gli errori di stato riga sono CE_FRAME, CE_OVERRUN e CE_RXPARITY. |
|
È stato rilevato un indicatore sonoro. |
|
Lo stato del segnale RLSD (receive-line-signal-detect) è cambiato. |
|
È stato ricevuto un carattere ed è stato collocato nel buffer di input. |
|
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 . |
|
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 |