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