IOCTL_SERIAL_INTERNAL_RESTORE_SETTINGS IOCTL (ntddser.h)
Die IOCTL_SERIAL_INTERNAL_RESTORE_SETTINGS-Anforderung stellt den angegebenen Betriebsmodus eines seriellen Geräts wieder her. Der angegebene Betriebsmodus sollte ein Modus sein, der von einer IOCTL_SERIAL_INTERNAL_BASIC_SETTINGS-Anforderung zurückgegeben wurde. Die Betriebsmoduseinstellungen sollten als undurchsichtig behandelt werden. Serial überprüft die Einstellungen nicht, wenn die Einstellungen wiederhergestellt werden. Beachten Sie auch, dass ein Ersatz für Serial möglicherweise einen anderen Satz von Parametern implementieren kann.
Hauptcode
IRP_MJ_INTERNAL_DEVICE_CONTROL
Eingabepuffer
Der AssociatedIrp.SystemBuffer-Member der IRP-Struktur verweist auf eine vom Client zugewiesene SERIAL_BASIC_SETTINGS-Struktur, die zum Eingeben von Betriebsmoduseinstellungen verwendet wird. Der Client sollte Einstellungen verwenden, die von einer IOCTL_SERIAL_INTERNAL_BASIC_SETTINGS-Anforderung zurückgegeben wurden.
Länge des Eingabepuffers
Das Parameters.DeviceIoControl.InputBufferLength-Element der IO_STACK_LOCATION-Struktur wird auf die Größe einer SERIAL_BASIC_SETTINGS-Struktur in Bytes festgelegt.
Ausgabepuffer
Keine.
Länge des Ausgabepuffers
Keine.
Statusblock
Wenn die Anforderung erfolgreich ist, wird der Information-Member auf die Größe SERIAL_BASIC_SETTINGS Struktur in Bytes festgelegt. Andernfalls wird das Information-Element auf 0 (null) festgelegt.
Das Element Status ist auf einen der generischen Statuswerte für Anforderungen der seriellen Gerätesteuerung festgelegt. Wenn Status auf STATUS_BUFFER_TOO_SMALL festgelegt ist, ist der Parameter.DeviceIoControl.InputBufferLength-Member der IO_STACK_LOCATION-Struktur kleiner als die Größe einer SERIAL_BASIC_SETTINGS-Struktur in Byte.
Anforderungen
| Anforderung | Wert |
|---|---|
| Header | ntddser.h (include Ntddser.h) |