Freigeben über


IOCTL_SERIAL_XOFF_COUNTER IOCTL (ntddser.h)

Die IOCTL_SERIAL_XOFF_COUNTER-Anforderung legt einen XOFF-Zähler fest. Eine XOFF-Zähleranforderung unterstützt Clients, die Software verwenden, um die Steuerung des Hardwarehandshaksflusses zu emulieren.

Eine XOFF-Leistungsindikatoranforderung wird mit Schreibanforderungen synchronisiert. Der Treiber sendet ein angegebenes XOFF-Zeichen und schließt die Anforderung ab, nachdem eines der folgenden Ereignisse auftritt:

  • Eine Schreibanforderung wird empfangen.
  • Ein Timer läuft ab (ein Timeoutwert wird von der XOFF-Leistungsindikatoranforderung angegeben).
  • Der Treiber des seriellen Controllers empfängt eine Anzahl von Zeichen, die größer oder gleich einer anzahl ist, die durch die XOFF-Zähleranforderung angegeben ist.
Weitere Informationen zum Betrieb eines XOFF-Indikators finden Sie in der Beschreibung der SERIAL_XOFF_COUNTER-Struktur in der Headerdatei Ntddser.h im Microsoft Windows Driver Kit (WDK).

Hauptcode

IRP_MJ_DEVICE_CONTROL

Eingabepuffer

AssociatedIrp.SystemBuffer verweist auf eine vom Client zugewiesene SERIAL_XOFF_COUNTER Struktur, die zum Eingeben von XOFF-Indikatorinformationen verwendet wird.

Länge des Eingabepuffers

Parameters.DeviceIoControl.InputBufferLength wird auf die Größe einer SERIAL_XOFF_COUNTER-Struktur in Bytes festgelegt.

Ausgabepuffer

Keine.

Länge des Ausgabepuffers

Keine.

Statusblock

Der Information-Member ist auf 0 (null) festgelegt.

Das Status-Element wird auf einen der generischen Statuswerte für Anforderungen der seriellen Gerätesteuerung oder auf einen der folgenden anforderungsspezifischen Werte festgelegt:

STATUS_INVALID_PARAMETER

Der für die XOFF-Zähleranforderung angegebene Zählerwert ist kleiner als 0 (null).

STATUS_SERIAL_COUNTER_TIMEOUT

Das Zeitlimit der Anforderung wurde überschritten.

STATUS_SERIAL_MORE_WRITES

Eine Schreibanforderung wurde empfangen.

Anforderungen

Anforderung Wert
Header ntddser.h (include Ntddser.h)

Weitere Informationen

IOCTL_SERIAL_SET_XOFF

IOCTL_SERIAL_SET_XON