Funzione SetCommState (winbase.h)
Configura un dispositivo di comunicazione in base alle specifiche in un blocco di controllo del dispositivo (una struttura DCB ). La funzione reinizializza tutte le impostazioni hardware e di controllo, ma non l'output vuoto o le code di input.
Sintassi
BOOL SetCommState(
[in] HANDLE hFile,
[in] LPDCB lpDCB
);
Parametri
[in] hFile
Handle per il dispositivo di comunicazione. La funzione CreateFile restituisce questo handle.
[in] lpDCB
Puntatore a una struttura DCB contenente le informazioni di configurazione per il dispositivo di comunicazione specificato.
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 SetCommState usa una struttura DCB per specificare la configurazione desiderata. La funzione GetCommState restituisce la configurazione corrente.
Per impostare solo alcuni membri della struttura DCB , è necessario modificare una struttura DCB compilata da una chiamata a GetCommState. Ciò garantisce che gli altri membri della struttura DCB abbiano valori appropriati.
La funzione SetCommState ha esito negativo se il membro XonChar della struttura DCB è uguale al membro XoffChar .
Quando setCommState viene usato per configurare l'8250, le restrizioni seguenti si applicano ai valori per i membri ByteSize e StopBits della struttura DCB:
Il numero di bit di dati deve essere compreso tra 5 e 8 bit.
Esempio
Per un esempio, vedere Configurazione di una risorsa 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 |