IOCTL_SERIAL_APPLY_DEFAULT_CONFIGURATION IOCTL (ntddser.h)

  • Articolo

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

IRP_MJ_DEVICE_CONTROL

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)

Vedi anche

IOCTL_SERIAL_SET_BAUD_RATE

IOCTL_SERIAL_SET_TIMEOUTS