IOCTL_SERIAL_INTERNAL_BASIC_SETTINGS IOCTL (ntddser.h)

Die IOCTL_SERIAL_INTERNAL_BASIC_SETTINGS Anforderung legt ein serielles Gerät auf einen grundlegenden Betriebsmodus fest. Der grundlegende Betriebsmodus von Serial 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 16550-UART-Schnittstelle verwendet. Beispiele für solche Treiber sind ein Maustreiber oder ein Grafikpadtreiber für ältere Hardware, die einen 16450-UART verwenden.

Die IOCTL_SERIAL_INTERNAL_BASIC_SETTINGS Anforderung gibt die Betriebsmoduseinstellungen zurück, die verwendet werden, bevor Serial den grundlegenden Betriebsmodus festlegt. Ein Client verwendet eine IOCTL_SERIAL_INTERNAL_RESTORE_SETTINGS-Anforderung , um einen vorherigen Betriebsmodus wiederherzustellen. 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

Keine.

Eingabepufferlänge

Keine.

Ausgabepuffer

AssociatedIrp.SystemBuffer verweist auf eine clientseitig zugewiesene SERIAL_BASIC_SETTINGS-Struktur, die Serial zum Ausgeben der aktuellen Konfiguration verwendet.

Länge des Ausgabepuffers

Parameters.DeviceIoControl.OutputBufferLength ist auf die Größe einer SERIAL_BASIC_SETTINGS-Struktur in Bytes festgelegt.

Statusblock

Wenn die Anforderung erfolgreich ist, wird das Element Information auf die Größe (in Bytes) von SERIAL_BASIC_SETTINGS festgelegt. Andernfalls wird das Element Information auf 0 festgelegt.

Das Statuselement ist auf einen der generischen Statuswerte für Anforderungen zur seriellen Gerätesteuerung festgelegt. Wenn Status auf STATUS_BUFFER_TOO_SMALL festgelegt ist, ist der Wert von Parameters.DeviceIoControl.OutputLength kleiner als die Größe einer SERIAL_BASIC_SETTINGS-Struktur in Bytes.

Anforderungen

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

Weitere Informationen

IOCTL_SERIAL_INTERNAL_RESTORE_SETTINGS