IOCTL_SERIAL_APPLY_DEFAULT_CONFIGURATION IOCTL (ntddser.h)
Il codice di controllo IOCTL_SERIAL_APPLY_DEFAULT_CONFIGURATION configura la porta seriale per usare le impostazioni hardware predefinite per il dispositivo del controller seriale. Queste impostazioni vengono ottenute dal descrittore di risorse ACPI per il dispositivo del controller seriale. Per altre informazioni, vedere la specifica ACPI 5.0.
Codice principale
Buffer di input
Nessuno.
Lunghezza del buffer di input
Nessuno.
Buffer di output
Nessuno.
Lunghezza del buffer di output
Nessuno.
Blocco dello stato
Il membro Information è impostato su zero.
Il membro Status è impostato su uno dei valori di stato generici per le richieste di controllo del dispositivo seriale. Lo stato di STATUS_NOT_IMPLEMENTED indica che la porta seriale non supporta una configurazione predefinita. In questo caso, il client deve usare le altre richieste di controllo I/OXXX IOCTL_SERIAL_XXX per configurare in modo esplicito la porta seriale.
Commenti
Il client (applicazione o driver di dispositivo periferico) invia questo IOCTL per configurare la porta seriale per usare un set di impostazioni di connessione predefinite. Queste impostazioni includono parametri hardware specifici della connessione, ad esempio la frequenza baud, i valori di timeout e i flag di controllo del flusso.
Questo IOCTL è supportato dalle versioni 1 e 2 dell'estensione del framework seriale (SerCx e SerCx2). Serial.sys, che gestisce le porte seriali denominate (COM1, COM2 e così via) in un PC, non supporta questo IOCTL.
Se una porta seriale non supporta questo IOCTL, il client deve specificare in modo esplicito le impostazioni di connessione per la porta. Ovvero, il client deve inviare una richiesta di IOCTL_SERIAL_SET_BAUD_RATE per impostare la velocità baud, inviare una richiesta di IOCTL_SERIAL_SET_TIMEOUTS per impostare gli intervalli di timeout e così via.
Immediatamente dopo l'apertura di una porta seriale, il client presuppone che la porta sia configurata in uno stato sconosciuto, non inizializzato anziché in uno stato noto e predefinito.
Requisiti
| Requisito | Valore |
|---|---|
| Client minimo supportato | Supportato a partire da Windows 8. |
| Intestazione | ntddser.h (include Ntddser.h) |