IOCTL_SERIAL_INTERNAL_RESTORE_SETTINGS IOCTL (ntddser.h)
La richiesta di IOCTL_SERIAL_INTERNAL_RESTORE_SETTINGS ripristina la modalità operativa specificata di un dispositivo seriale. La modalità operativa specificata deve essere una modalità restituita da una richiesta di IOCTL_SERIAL_INTERNAL_BASIC_SETTINGS . Le impostazioni della modalità operativa devono essere considerate opache. Seriale non verifica le impostazioni quando vengono ripristinate le impostazioni. Si noti anche che una sostituzione di Serial potrebbe implementare un set diverso di parametri.
Codice principale
IRP_MJ_INTERNAL_DEVICE_CONTROL
Buffer di input
Il membro AssociatedIrp.SystemBuffer della struttura IRP punta a una struttura SERIAL_BASIC_SETTINGS allocata dal client usata per l'input delle impostazioni della modalità operativa. Il client deve usare le impostazioni restituite da una richiesta di IOCTL_SERIAL_INTERNAL_BASIC_SETTINGS.
Lunghezza del buffer di input
Il membro Parameters.DeviceIoControl.InputBufferLength della struttura IO_STACK_LOCATION è impostato sulle dimensioni, in byte, di una struttura SERIAL_BASIC_SETTINGS.
Buffer di output
Nessuno.
Lunghezza del buffer di output
Nessuno.
Blocco dello stato
Se la richiesta ha esito positivo, il membro Informazioni viene impostato sulla dimensione, espressa in byte, della struttura di SERIAL_BASIC_SETTINGS. In caso contrario, il membro Informazioni è impostato su zero.
Il membro Status è impostato su uno dei valori di stato generici per le richieste di controllo del dispositivo seriale. Se Status è impostato su STATUS_BUFFER_TOO_SMALL, il membro Parameters.DeviceIoControl.InputBufferLength della struttura IO_STACK_LOCATION è minore delle dimensioni, in byte, di una struttura SERIAL_BASIC_SETTINGS.
Requisiti
| Requisito | Valore |
|---|---|
| Intestazione | ntddser.h (include Ntddser.h) |