IOCTL_SERIAL_APPLY_DEFAULT_CONFIGURATION IOCTL (ntddser.h)
El código de control IOCTL_SERIAL_APPLY_DEFAULT_CONFIGURATION configura el puerto serie para usar la configuración de hardware predeterminada para el dispositivo de controlador serie. Esta configuración se obtiene del descriptor de recursos ACPI para el dispositivo de controlador serie. Para obtener más información, consulte la especificación ACPI 5.0.
Código principal
Búfer de entrada
Ninguno.
Longitud del búfer de entrada
Ninguno.
Búfer de salida
Ninguno.
Longitud del búfer de salida
Ninguno.
Bloque de estado
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. Un estado de STATUS_NOT_IMPLEMENTED indica que el puerto serie no admite una configuración predeterminada. En este caso, el cliente debe usar las demás solicitudes de control de E/S IOCTL_SERIAL_XXX para configurar explícitamente el puerto serie.
Comentarios
El cliente (controlador de dispositivo periférico o de aplicación) envía este IOCTL para configurar el puerto serie para usar un conjunto de valores de conexión predeterminados. Esta configuración incluye parámetros de hardware específicos de la conexión, como la velocidad de baudios, los valores de tiempo de espera y las marcas de control de flujo.
Esta IOCTL es compatible con las versiones 1 y 2 de la extensión del marco de trabajo serie (SerCx y SerCx2). Serial.sys, que administra los puertos serie con nombre (COM1, COM2, etc.) en un equipo, no admite este IOCTL.
Si un puerto serie no admite este IOCTL, el cliente debe especificar explícitamente la configuración de conexión para el puerto. Es decir, el cliente debe enviar una solicitud de IOCTL_SERIAL_SET_BAUD_RATE para establecer la velocidad de baudios, enviar una solicitud de IOCTL_SERIAL_SET_TIMEOUTS para establecer los intervalos de tiempo de espera, etc.
Inmediatamente después de que un cliente abra un puerto serie, el cliente debe asumir que el puerto está configurado en un estado desconocido sin inicializar en lugar de en algún estado conocido y predeterminado.
Requisitos
Requisito | Value |
---|---|
Cliente mínimo compatible | Se admite a partir de Windows 8. |
Encabezado | ntddser.h (incluya Ntddser.h) |