Freigeben über


SERIAL_HANDFLOW Struktur (ntddser.h)

Die SERIAL_HANDFLOW-Struktur gibt die Handshake- und Flusssteuerungseinstellungen für einen seriellen Anschluss an.

Syntax

typedef struct _SERIAL_HANDFLOW {
  ULONG ControlHandShake;
  ULONG FlowReplace;
  LONG  XonLimit;
  LONG  XoffLimit;
} SERIAL_HANDFLOW, *PSERIAL_HANDFLOW;

Angehörige

ControlHandShake

Eine Bitmaske, die die Steuerlinien angibt, die der serielle Anschluss für die Flusssteuerung verwendet. Dieses Element wird auf Null oder auf das bitweise ODER mindestens eine der folgenden Flags festgelegt.

Wert Beschreibung
SERIAL_DTR_CONTROL DTR (Datenterminal bereit) ist aktiviert.
SERIAL_DTR_HANDSHAKE DTR wird für die Eingabeflusssteuerung verwendet.
SERIAL_CTS_HANDSHAKE CTS (clear to send) wird für die Ausgabeflusssteuerung verwendet.
SERIAL_DSR_HANDSHAKE DsR (data set ready) wird für die Ausgabeflusssteuerung verwendet.
SERIAL_DCD_HANDSHAKE DCD (Data Carrier Detect) wird für die Ausgabeflusssteuerung verwendet.
SERIAL_DSR_SENSITIVITY Ignorieren Sie Zeichen, die am seriellen Port ankommen, wenn die DsR-Zeile inaktiv ist.
SERIAL_ERROR_ABORT Abbrechen eines Sende- oder Empfangsvorgangs, wenn ein Fehler auftritt.
 

SerCx2 unterstützt das SERIAL_CTS_HANDSHAKE-Flag und unterstützt je nach serieller Controllerhardware die anderen sechs für dieses Element definierten Flags oder nicht. SerCx unterstützt nur die ersten vier Flags in der vorherigen Tabelle. Serial.sys unterstützt alle Flags in der vorherigen Tabelle.

FlowReplace

Eine Bitmaske, die das Verhalten der Flusssteuerung angibt. Dieses Element wird auf Null oder auf das bitweise ODER mindestens eine der folgenden Flags festgelegt.

Wert Beschreibung
SERIAL_AUTO_TRANSMIT Verwenden Sie XON/XOFF für die Flusssteuerung der übertragenen Daten.
SERIAL_AUTO_RECEIVE Verwenden Sie XON/XOFF für die Flusssteuerung empfangener Daten.
SERIAL_ERROR_CHAR Fügen Sie das Fehlerzeichen in die empfangenen Daten ein, wenn ein Fehler auftritt. Weitere Informationen finden Sie in der Beschreibung des ErrorChar- Mitglieds in SERIAL_CHARS.
SERIAL_NULL_STRIPPING Automatisches Entfernen von NULL-Zeichen aus empfangenen Daten.
SERIAL_BREAK_CHAR Fügen Sie das Umbruchzeichen in die empfangenen Daten ein, wenn ein Umbruch auftritt. Weitere Informationen finden Sie in der Beschreibung des BreakChar- Mitglieds in SERIAL_CHARS.
SERIAL_RTS_CONTROL RTS (Anforderung zum Senden) ist aktiviert.
SERIAL_RTS_HANDSHAKE RTS wird für die Ausgabeflusssteuerung verwendet.
SERIAL_XOFF_CONTINUE Fahren Sie nach dem Senden von XOFF an das Gerät am anderen Ende der Zeile fort.
 

SerCx2 unterstützt die SERIAL_RTS_CONTROL und SERIAL_RTS_HANDSHAKE Flags, unterstützt jedoch in der Regel nicht die anderen sechs Flags, die für dieses Element definiert sind, abhängig vom seriellen Controllertreiber und den Funktionen der seriellen Controllerhardware. SerCx unterstützt nur die SERIAL_RTS_CONTROL- und SERIAL_RTS_HANDSHAKE Flags. Serial.sys unterstützt alle Flags in der vorherigen Tabelle.

XonLimit

XON-Grenzwert. Wenn die Anzahl der Zeichen im internen Empfangspuffer unter den XON-Grenzwert fällt, verwendet der serielle Controllertreiber die Flusssteuerungssignale, um dem Absender mitzuteilen, dass die Sendezeichen fortgesetzt werden.

XoffLimit

XOFF-Grenzwert. Wenn die Anzahl der Zeichen im internen Empfangspuffer den XOFF-Grenzwert erreicht, verwendet der serielle Controllertreiber die Flusssteuerungssignale, um dem Absender mitzuteilen, dass die Sendezeichen nicht mehr gesendet werden.

Bemerkungen

Diese Struktur wird von den anforderungen IOCTL_SERIAL_GET_HANDFLOW und IOCTL_SERIAL_SET_HANDFLOW verwendet.

Nach dem Senden eines XOFF-Zeichens (Sende off) wird der serielle Anschluss nicht mehr gesendet, ohne weitere Zeichen zu senden. Dieses Verhalten unterstützt serielle Ports, die jedes Zeichen interpretieren, das einem XOFF folgt, als impliziertes XON (Übertragung ein).

SerCx2 und SerCx unterstützen nur Teilmengen der Flags, die für die ControlHandShake- und FlowControl--Member definiert sind. Eine IOCTL_SERIAL_SET_HANDFLOW Anforderung, die ein nicht unterstütztes Flag angibt, wird mit STATUS_NOT_IMPLEMENTED abgeschlossen.

Anforderungen

Anforderung Wert
Header- ntddser.h

Siehe auch

IOCTL_SERIAL_GET_HANDFLOW

IOCTL_SERIAL_SET_HANDFLOW