IOCTL_SERIAL_INTERNAL_BASIC_SETTINGS IOCTL (ntddser.h)
La solicitud IOCTL_SERIAL_INTERNAL_BASIC_SETTINGS establece un dispositivo serie en un modo de funcionamiento básico. El modo de funcionamiento 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 parte de un controlador que usa un subconjunto de la interfaz UART 16550. Algunos ejemplos de estos controladores incluyen un controlador de mouse o un controlador de panel gráficos para hardware anterior que usan un UART de 16450.
La solicitud IOCTL_SERIAL_INTERNAL_BASIC_SETTINGS devuelve la configuración del modo operativo que se usa justo antes de que Serial establezca el modo de operación básico. 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 opaca. Serial no comprueba la configuración cuando se restaura la configuración. Tenga en cuenta también que un controlador de reemplazo para serie puede implementar un conjunto diferente de opciones 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
El AssociatedIrp.SystemBu ffer 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
El 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 de Information está establecido en cero.
El miembro Estado de se establece en uno de los valores de estado genéricos de para solicitudes de control de dispositivos serie. Si estado se establece en STATUS_BUFFER_TOO_SMALL, el valor de Parameters.DeviceIoControl.OutputLength es menor que el tamaño, en bytes, de una estructura SERIAL_BASIC_SETTINGS.
Requisitos
| Requisito | Valor |
|---|---|
| encabezado de | ntddser.h (incluya Ntddser.h) |