IOCTL_SERIAL_APPLY_DEFAULT_CONFIGURATION IOCTL (ntddser.h)

IOCTL_SERIAL_APPLY_DEFAULT_CONFIGURATION 控制代码将串行端口配置为使用串行控制器设备的默认硬件设置。 这些设置是从串行控制器设备的 ACPI 资源描述符获取的。 有关详细信息,请参阅 ACPI 5.0 规范

主要代码

IRP_MJ_DEVICE_CONTROL

输入缓冲区

没有。

输入缓冲区长度

没有。

输出缓冲区

没有。

输出缓冲区长度

没有。

状态块

信息 成员设置为零。

状态 成员设置为串行设备控制请求 泛型状态值之一。 STATUS_NOT_IMPLEMENTED的状态指示串行端口不支持默认配置。 在这种情况下,客户端必须使用其他 IOCTL_SERIAL_XXX I/O 控制请求来显式配置串行端口。

言论

客户端(应用程序或外围设备驱动程序)发送此 IOCTL 以配置串行端口以使用一组默认连接设置。 这些设置包括特定于连接的硬件参数,例如波特率、超时值和流控制标志。

串行框架扩展版本 1 和 2 支持此 IOCTL(SerCx 和 SerCx2)。 Serial.sys在电脑上管理命名串行端口(COM1、COM2 等)不支持此 IOCTL。

如果串行端口不支持此 IOCTL,客户端必须显式指定端口的连接设置。 也就是说,客户端必须发送 IOCTL_SERIAL_SET_BAUD_RATE 请求来设置波特率、发送 IOCTL_SERIAL_SET_TIMEOUTS 请求来设置超时间隔等。

在客户端打开串行端口后,客户端应假定该端口处于未知未初始化状态而不是处于某些已知默认状态。

要求

要求 价值
最低支持的客户端 从 Windows 8 开始支持。
标头 ntddser.h (包括 Ntddser.h)

另请参阅

IOCTL_SERIAL_SET_BAUD_RATE

IOCTL_SERIAL_SET_TIMEOUTS