IOCTL_SERIAL_INTERNAL_BASIC_SETTINGS IOCTL (ntddser.h)
La solicitud IOCTL_SERIAL_INTERNAL_BASIC_SETTINGS establece un dispositivo serie en un modo operativo básico. El modo operativo básico de serie lee y escribe un byte a la vez y no usa el control de flujo de protocolo de enlace ni los tiempos de espera. El modo de operación básica es adecuado para su uso por un controlador que usa un subconjunto de la interfaz UART 16550. Algunos ejemplos de estos controladores incluyen un controlador del mouse o un controlador de panel gráfico para hardware anterior que usan un UART 16450.
La solicitud IOCTL_SERIAL_INTERNAL_BASIC_SETTINGS devuelve la configuración del modo de funcionamiento que está en uso justo antes de que Serial establezca el modo de operación básica. Un cliente usa una solicitud de IOCTL_SERIAL_INTERNAL_RESTORE_SETTINGS para restaurar un modo operativo anterior. Un cliente debe tratar la configuración del modo de funcionamiento como opaco. Serial no comprueba la configuración cuando se restauran las opciones. Tenga en cuenta también que un controlador de reemplazo para Serial puede implementar un conjunto diferente de configuraciones básicas.
Código principal
IRP_MJ_INTERNAL_DEVICE_CONTROL
Búfer de entrada
Ninguno.
Longitud del búfer de entrada
Ninguno.
Búfer de salida
AssociatedIrp.SystemBuffer apunta a una estructura de SERIAL_BASIC_SETTINGS asignada por el cliente que serial usa para generar la configuración actual.
Longitud del búfer de salida
Parameters.DeviceIoControl.OutputBufferLength se establece en el tamaño, en bytes, de una estructura de SERIAL_BASIC_SETTINGS.
Bloque de estado
Si la solicitud se realiza correctamente, el miembro Information se establece en el tamaño, en bytes, de SERIAL_BASIC_SETTINGS. De lo contrario, el miembro Information se establece en cero.
El miembro Status se establece en uno de los valores de estado genéricos para las solicitudes de control de dispositivos serie. Si Status se establece en STATUS_BUFFER_TOO_SMALL, el valor de Parameters.DeviceIoControl.OutputLength es menor que el tamaño, en bytes, de una estructura de SERIAL_BASIC_SETTINGS.
Requisitos
| Requisito | Valor |
|---|---|
| Header | ntddser.h (incluya Ntddser.h) |