IOCTL_SERIAL_INTERNAL_BASIC_SETTINGS IOCTL (ntddser.h)
Die anforderung IOCTL_SERIAL_INTERNAL_BASIC_SETTINGS legt ein serielles Gerät auf einen grundlegenden Betriebsmodus fest. Der grundlegende Betriebsmodus der seriellen Serie liest und schreibt jeweils ein Byte und verwendet keine Handshakeflusssteuerung oder Timeouts. Der grundlegende Betriebsmodus eignet sich für die Verwendung durch einen Treiber, der eine Teilmenge der UART-Schnittstelle 16550 verwendet. Beispiele für solche Treiber sind ein Maustreiber oder ein Grafikpadtreiber für ältere Hardware, die eine UART 16450 verwenden.
Die IOCTL_SERIAL_INTERNAL_BASIC_SETTINGS Anforderung gibt die Betriebsmoduseinstellungen zurück, die gerade verwendet werden, bevor Serial den grundlegenden Betriebsmodus festlegt. Ein Client verwendet eine IOCTL_SERIAL_INTERNAL_RESTORE_SETTINGS Anforderung zum Wiederherstellen eines vorherigen Betriebsmodus. Ein Client sollte die Betriebsmoduseinstellungen als undurchsichtig behandeln. Serial überprüft die Einstellungen nicht, wenn die Einstellungen wiederhergestellt werden. Beachten Sie auch, dass ein Ersatztreiber für Serial möglicherweise einen anderen Satz grundlegender Einstellungen implementiert.
Hauptcode
IRP_MJ_INTERNAL_DEVICE_CONTROL
Eingabepuffer
Nichts.
Eingabepufferlänge
Nichts.
Ausgabepuffer
Die AssociatedIrp.SystemBuffer- verweist auf eine vom Client zugewiesene SERIAL_BASIC_SETTINGS Struktur, die serial zum Ausgeben der aktuellen Konfiguration verwendet.
Länge des Ausgabepuffers
Die Parameters.DeviceIoControl.OutputBufferLength wird auf die Größe einer SERIAL_BASIC_SETTINGS-Struktur in Bytes festgelegt.
Statusblock
Wenn die Anforderung erfolgreich ist, wird der Information Member auf die Größe von SERIAL_BASIC_SETTINGS in Byte festgelegt. Andernfalls wird der Information Member auf Null festgelegt.
Der Status- Member ist auf einen der generischen Statuswerte für anforderungen für serielle Gerätesteuerungfestgelegt. Wenn Status- auf STATUS_BUFFER_TOO_SMALL festgelegt ist, ist der Wert Parameters.DeviceIoControl.OutputLength- kleiner als die Größe einer SERIAL_BASIC_SETTINGS Struktur in Byte.
Anforderungen
Anforderung | Wert |
---|---|
Header- | ntddser.h (include Ntddser.h) |