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 |