IOCTL_SERIAL_APPLY_DEFAULT_CONFIGURATION IOCTL (ntddser.h)

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

主要代码

IRP_MJ_DEVICE_CONTROL

输入缓冲区

无。

输入缓冲区长度

无。

输出缓冲区

无。

输出缓冲区长度

无。

状态块

信息成员设置为零。

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

注解

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

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

如果串行端口不支持此 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