SetCommState-Funktion (winbase.h)
Konfiguriert ein Kommunikationsgerät gemäß den Spezifikationen in einem Gerätesteuerungsblock ( DCB-Struktur ). Die Funktion initialisiert alle Hardware- und Steuerungseinstellungen neu, leert jedoch keine Ausgabe- oder Eingabewarteschlangen.
Syntax
BOOL SetCommState(
[in] HANDLE hFile,
[in] LPDCB lpDCB
);
Parameter
[in] hFile
Ein Handle für das Kommunikationsgerät. Die CreateFile-Funktion gibt dieses Handle zurück.
[in] lpDCB
Ein Zeiger auf eine DCB-Struktur , die die Konfigurationsinformationen für das angegebene Kommunikationsgerät enthält.
Rückgabewert
Wenn die Funktion erfolgreich ist, ist der Rückgabewert ungleich Null.
Wenn die Funktion fehlerhaft ist, ist der Rückgabewert null. Um erweiterte Fehlerinformationen zu erhalten, rufen Sie GetLastError auf.
Hinweise
Die SetCommState-Funktion verwendet eine DCB-Struktur , um die gewünschte Konfiguration anzugeben. Die GetCommState-Funktion gibt die aktuelle Konfiguration zurück.
Um nur einige Elemente der DCB-Struktur festzulegen, sollten Sie eine DCB-Struktur ändern, die durch einen Aufruf von GetCommState ausgefüllt wurde. Dadurch wird sichergestellt, dass die anderen Member der DCB-Struktur über geeignete Werte verfügen.
Die SetCommState-Funktion schlägt fehl, wenn das XonChar-Element der DCB-Struktur gleich dem XoffChar-Element ist.
Wenn SetCommState zum Konfigurieren des 8250 verwendet wird, gelten die folgenden Einschränkungen für die Werte für die ByteSize- und StopBits-Member der DCB-Struktur:
Die Anzahl der Datenbits muss 5 bis 8 Bits sein.
Beispiele
Ein Beispiel finden Sie unter Konfigurieren einer Kommunikationsressource.
Anforderungen
| Anforderung | Wert |
|---|---|
| Unterstützte Mindestversion (Client) | Windows XP [Desktop-Apps | UWP-Apps] |
| Unterstützte Mindestversion (Server) | Windows Server 2003 [Desktop-Apps | UWP-Apps] |
| Zielplattform | Windows |
| Kopfzeile | winbase.h (einschließlich Windows.h) |
| Bibliothek | Kernel32.lib |
| DLL | Kernel32.dll |