IOCTL_SERIAL_XOFF_COUNTER IOCTL (ntddser.h)
Die IOCTL_SERIAL_XOFF_COUNTER-Anforderung legt einen XOFF-Zählerfest. Eine XOFF-Leistungsanforderung unterstützt Clients, die Software zum Emulieren der Hardware-Handshake-Flusssteuerung verwenden.
Eine XOFF-Zähleranforderung wird mit Schreibanforderungen synchronisiert. Der Treiber sendet ein angegebenes XOFF-Zeichen und schließt die Anforderung nach einem der folgenden Ereignisse ab:
- Eine Schreibanforderung wird empfangen.
- Ein Timer läuft ab (ein Timeoutwert wird durch die XOFF-Zähleranforderung angegeben).
- Der Treiber des seriellen Controllers empfängt eine Anzahl von Zeichen, die größer oder gleich einer von der XOFF-Leistungsanforderung angegebenen Anzahl sind.
Hauptcode
Eingabepuffer
Die AssociatedIrp.SystemBuffer- verweist auf eine vom Client zugewiesene SERIAL_XOFF_COUNTER Struktur, die zum Eingeben von XOFF-Leistungsindikatoreninformationen verwendet wird.
Eingabepufferlänge
Die Parameters.DeviceIoControl.InputBufferLength wird auf die Größe einer SERIAL_XOFF_COUNTER-Struktur in Bytes festgelegt.
Ausgabepuffer
Nichts.
Länge des Ausgabepuffers
Nichts.
Statusblock
Das Information Member ist auf Null festgelegt.
Der Status- Member wird auf einen der generischen Statuswerte für serial Device Control Requests oder auf einen der folgenden anforderungsspezifischen Werte festgelegt:
STATUS_INVALID_PARAMETER
Der für die XOFF-Zähleranforderung angegebene Anzahlwert ist kleiner als 0.
STATUS_SERIAL_COUNTER_TIMEOUT
Timeout der Anforderung.
STATUS_SERIAL_MORE_WRITES
Eine Schreibanforderung wurde empfangen.
Anforderungen
Anforderung | Wert |
---|---|
Header- | ntddser.h (include Ntddser.h) |