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.
Hauptcode
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) |