IOCTL_SERIAL_APPLY_DEFAULT_CONFIGURATION IOCTL (ntddser.h)
Der IOCTL_SERIAL_APPLY_DEFAULT_CONFIGURATION-Steuerelementcode 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
Nichts.
Eingabepufferlänge
Nichts.
Ausgabepuffer
Nichts.
Länge des Ausgabepuffers
Nichts.
Statusblock
Das Information Member ist auf Null festgelegt.
Der Status- Member wird auf einen der generischen Statuswerte für serielle Gerätesteuerungsanforderungenfestgelegt. Ein 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-Steuerelementanforderungen verwenden, um den seriellen Port explizit zu konfigurieren.
Bemerkungen
Der Client (Anwendungs- oder Peripheriegerätetreiber) sendet diese IOCTL, um den seriellen Port so zu konfigurieren, dass eine Reihe von Standardverbindungseinstellungen verwendet wird. Zu diesen Einstellungen gehören verbindungsspezifische Hardwareparameter wie baudrate, Timeoutwerte und Flusssteuerungskennzeichnungen.
Diese IOCTL wird von den Versionen 1 und 2 der seriellen Framework-Erweiterung (SerCx und SerCx2) unterstützt. Serial.sys, der 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 explizit die Verbindungseinstellungen für den Port angeben. Das heißt, der Client muss eine IOCTL_SERIAL_SET_BAUD_RATE Anforderung zum Festlegen der Baudrate senden, 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 und nicht in einem bekannten Standardzustand konfiguriert ist.
Anforderungen
| Anforderung | Wert |
|---|---|
| mindestens unterstützte Client- | Wird ab Windows 8 unterstützt. |
| Header- | ntddser.h (include Ntddser.h) |