IOCTL_SERIAL_APPLY_DEFAULT_CONFIGURATION IOCTL (ntddser.h)
Il codice di controllo IOCTL_SERIAL_APPLY_DEFAULT_CONFIGURATION configura la porta seriale per l'uso delle impostazioni hardware predefinite per il dispositivo controller seriale. Queste impostazioni vengono ottenute dal descrittore di risorse ACPI per il dispositivo 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 di stato
Il membro Informazioni è impostato su zero.
Il membro Status è impostato su uno dei valori di stato generico 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 IOCTL_SERIAL_XXX richieste di controllo di I/O per configurare in modo esplicito la porta seriale.
Osservazioni
Il client (driver di dispositivo applicazione o periferica) invia questo IOCTL per configurare la porta seriale per l'uso di un set di impostazioni di connessione predefinite. Queste impostazioni includono parametri hardware specifici della connessione, ad esempio la velocità 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.
Subito dopo che un client apre una porta seriale, il client deve presupporre che la porta sia configurata in uno stato sconosciuto e non inizializzato anziché in uno stato predefinito noto.
Fabbisogno
| Requisito | Valore |
|---|---|
| client minimo supportato | Supportato a partire da Windows 8. |
| intestazione | ntddser.h (include Ntddser.h) |