EscapeCommFunction-Funktion (winbase.h)

Weist das angegebene Kommunikationsgerät an, eine erweiterte Funktion auszuführen.

Syntax

BOOL EscapeCommFunction(
  [in] HANDLE hFile,
  [in] DWORD  dwFunc
);

[in] hFile

Ein Handle für das Kommunikationsgerät. Die CreateFile-Funktion gibt dieses Handle zurück.

[in] dwFunc

Die auszuführende erweiterte Funktion. Dieser Parameter kann einen der folgenden Werte annehmen.

Wert	Bedeutung
CLRBREAK 9	Stellt die Zeichenübertragung wieder her und versetzt die Übertragungsleitung in einen unterbrechungsfreien Zustand. Der Code der erweiterten CLRBREAK-Funktion ist identisch mit der ClearCommBreak-Funktion .
CLRDTR 6	Löscht das DTR-Signal (data-terminal-ready).
CLRRTS 4	Löscht das RTS-Signal (Request-to-Send).
SETBREAK 8	Hält die Zeichenübertragung an und versetzt die Übertragungsleitung in einen Unterbrechungszustand, bis die ClearCommBreak-Funktion aufgerufen wird (oder EscapeCommFunction mit dem code der erweiterten CLRBREAK-Funktion aufgerufen wird). Der Code der erweiterten SETBREAK-Funktion ist identisch mit der SetCommBreak-Funktion . Beachten Sie, dass diese erweiterte Funktion keine Daten leert, die nicht übertragen wurden.
SETDTR 5	Sendet das DTR-Signal (data-terminal-ready).
SETRTS 3	Sendet das RTS-Signal (Request-to-Send).
SETXOFF 1	Bewirkt, dass die Übertragung so wirkt, als ob ein XOFF-Zeichen empfangen wurde.
SETXON 2	Bewirkt, dass die Übertragung so wirkt, als ob ein XON-Zeichen empfangen wurde.

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.

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 (Windows.h einschließen)
Bibliothek	Kernel32.lib
DLL	Kernel32.dll