Compartir a través de

IOCTL_SERIAL_APPLY_DEFAULT_CONFIGURATION IOCTL (ntddser.h)

  • Artículo

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

IRP_MJ_DEVICE_CONTROL

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)

Consulte también

IOCTL_SERIAL_SET_BAUD_RATE

IOCTL_SERIAL_SET_TIMEOUTS