Freigeben über


IOCTL_SERIAL_APPLY_DEFAULT_CONFIGURATION IOCTL (ntddser.h)

Der IOCTL_SERIAL_APPLY_DEFAULT_CONFIGURATION-Steuerungscode konfiguriert den seriellen Port so, dass die Standardhardwareeinstellungen für das serielle Controllergerät verwendet werden. Diese Einstellungen werden vom ACPI-Ressourcendeskriptor für das serielle Controllergerät abgerufen. Weitere Informationen finden Sie in der ACPI 5.0-Spezifikation.

Hauptcode

IRP_MJ_DEVICE_CONTROL

Eingabepuffer

Keine.

Eingabepufferlänge

Keine.

Ausgabepuffer

Keine.

Länge des Ausgabepuffers

Keine.

Statusblock

Das Element Information ist auf 0 festgelegt.

Das Statuselement ist auf einen der generischen status-Werte für Anforderungen zur seriellen Gerätesteuerung festgelegt. Eine status von STATUS_NOT_IMPLEMENTED gibt an, dass der serielle Port keine Standardkonfiguration unterstützt. In diesem Fall muss der Client die anderen IOCTL_SERIAL_XXX-E /A-Steuerungsanforderungen verwenden, um den seriellen Port explizit zu konfigurieren.

Hinweise

Der Client (Anwendungs- oder Peripheriegerätetreiber) sendet diese IOCTL, um den seriellen Port für die Verwendung einer Reihe von Standardverbindungseinstellungen zu konfigurieren. Zu diesen Einstellungen gehören verbindungsspezifische Hardwareparameter wie baudrate, Timeoutwerte und Flusssteuerungsflags.

Diese IOCTL wird von den Versionen 1 und 2 der seriellen Frameworkerweiterung (SerCx und SerCx2) unterstützt. Serial.sys, die die benannten seriellen Ports (COM1, COM2 usw.) auf einem PC verwaltet, unterstützt diese IOCTL nicht.

Wenn ein serieller Port diese IOCTL nicht unterstützt, muss der Client die Verbindungseinstellungen für den Port explizit angeben. Das heißt, der Client muss eine IOCTL_SERIAL_SET_BAUD_RATE Anforderung senden, um die Baudrate festzulegen, eine IOCTL_SERIAL_SET_TIMEOUTS Anforderung senden, um die Timeoutintervalle festzulegen usw.

Unmittelbar nachdem ein Client einen seriellen Port geöffnet hat, sollte der Client davon ausgehen, dass der Port in einem unbekannten, nicht initialisierten Zustand konfiguriert ist und nicht in einem bekannten Standardzustand.

Anforderungen

Anforderung Wert
Unterstützte Mindestversion (Client) Wird ab Windows 8 unterstützt.
Kopfzeile ntddser.h (include Ntddser.h)

Weitere Informationen

IOCTL_SERIAL_SET_BAUD_RATE

IOCTL_SERIAL_SET_TIMEOUTS