IOCTL_SERIAL_INTERNAL_BASIC_SETTINGS IOCTL (ntddser.h)

  • Articolo

La richiesta IOCTL_SERIAL_INTERNAL_BASIC_SETTINGS imposta un dispositivo seriale su una modalità operativa di base. La modalità operativa di base della seriale legge e scrive un byte alla volta e non usa il controllo del flusso di handshake o timeout. La modalità operativa di base è adatta per l'uso da parte di un driver che usa un subset dell'interfaccia UART 16550. Esempi di tali driver includono un driver del mouse o un driver del pad grafico per hardware meno recente che usa un UART 16450.

La richiesta IOCTL_SERIAL_INTERNAL_BASIC_SETTINGS restituisce le impostazioni della modalità operativa in uso subito prima che Serial imposti la modalità operativa di base. Un client usa una richiesta di IOCTL_SERIAL_INTERNAL_RESTORE_SETTINGS per ripristinare una modalità operativa precedente. Un client deve considerare le impostazioni della modalità operativa come opache. Seriale non verifica le impostazioni quando vengono ripristinate le impostazioni. Si noti anche che un driver sostitutivo per seriale potrebbe implementare un set diverso di impostazioni di base.

Codice principale

IRP_MJ_INTERNAL_DEVICE_CONTROL

Buffer di input

Nessuno.

Lunghezza del buffer di input

Nessuno.

Buffer di output

AssociatedIrp.SystemBuffer punta a una struttura SERIAL_BASIC_SETTINGS allocata dal client usata da Serial per restituire la configurazione corrente.

Lunghezza del buffer di output

Parameters.DeviceIoControl.OutputBufferLength è impostato sulle dimensioni, in byte, di una struttura SERIAL_BASIC_SETTINGS.

Blocco dello stato

Se la richiesta ha esito positivo, il membro Informazioni viene impostato sulla dimensione, espressa in byte, 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 valore di Parameters.DeviceIoControl.OutputLength è minore delle dimensioni, in byte, di una struttura SERIAL_BASIC_SETTINGS.

Requisiti

Requisito Valore
Intestazione ntddser.h (include Ntddser.h)

Vedi anche

IOCTL_SERIAL_INTERNAL_RESTORE_SETTINGS