IOCTL_SERIAL_APPLY_DEFAULT_CONFIGURATION IOCTL (ntddser.h)
Код управления IOCTL_SERIAL_APPLY_DEFAULT_CONFIGURATION настраивает последовательный порт для использования параметров оборудования по умолчанию для устройства последовательного контроллера. Эти параметры получены из дескриптора ресурсов ACPI для устройства последовательного контроллера. Дополнительные сведения см. в спецификации ACPI 5.0.
Основной код
Входной буфер
Никакой.
Длина входного буфера
Никакой.
Выходной буфер
Никакой.
Длина выходного буфера
Никакой.
Блок состояния
Элемент Information имеет значение нулю.
Элемент status имеет одно из универсальных значений состояния для запросов последовательного управления устройствами. Состояние STATUS_NOT_IMPLEMENTED указывает, что последовательный порт не поддерживает конфигурацию по умолчанию. В этом случае клиент должен использовать другие запросы управления IOCTL_SERIAL_XXX ввода-вывода, чтобы явно настроить последовательный порт.
Замечания
Клиент (драйвер приложения или периферийных устройств) отправляет этот IOCTL для настройки последовательного порта для использования набора параметров подключения по умолчанию. К этим параметрам относятся параметры оборудования, относящиеся к подключению, такие как скорость baud, значения времени ожидания и флаги управления потоком.
Этот IOCTL поддерживается версиями 1 и 2 расширения последовательной платформы (SerCx и SerCx2). Serial.sys, который управляет именованных последовательных портов (COM1, COM2 и т. д.) на компьютере, не поддерживает этот протокол IOCTL.
Если последовательный порт не поддерживает этот протокол IOCTL, клиент должен явно указать параметры подключения для порта. То есть клиент должен отправить запрос IOCTL_SERIAL_SET_BAUD_RATE, чтобы задать скорость выполнения, отправить запрос IOCTL_SERIAL_SET_TIMEOUTS, чтобы задать интервалы времени ожидания и т. д.
Сразу после того, как клиент открывает последовательный порт, клиент должен предположить, что порт настроен в неизвестном, неинициализированном состоянии, а не в известном состоянии по умолчанию.
Требования
Требование | Ценность |
---|---|
минимальные поддерживаемые клиентские | Поддерживается начиная с Windows 8. |
заголовка | ntddser.h (include Ntddser.h) |