Freigeben über


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.
Weitere Informationen zum Vorgang eines XOFF-Zählers finden Sie in der Beschreibung der SERIAL_XOFF_COUNTER Struktur in der Ntddser.h-Headerdatei im Microsoft Windows Driver Kit (WDK).

Hauptcode

IRP_MJ_DEVICE_CONTROL

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)

Siehe auch

IOCTL_SERIAL_SET_XOFF

IOCTL_SERIAL_SET_XON