SetCommState-Funktion (winbase.h)

Artikel
03/03/2024

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