IOCTL_SERIAL_XOFF_COUNTER IOCTL (ntddser.h)
Запрос IOCTL_SERIAL_XOFF_COUNTER задает счетчик XOFF. Запрос счетчика XOFF поддерживает клиенты, использующие программное обеспечение для эмуляции управления потоком подтверждения оборудования.
Запрос счетчика XOFF синхронизируется с запросами на запись. Драйвер отправляет указанный символ XOFF и завершает запрос после одного из следующих событий:
- Получен запрос на запись.
- Истекает срок действия таймера (значение времени ожидания указывается в запросе счетчика XOFF).
- Драйвер последовательного контроллера получает число символов, которое больше или равно числу, заданному запросом счетчика XOFF.
Основной код
Входной буфер
AssociatedIrp.SystemBuffer указывает на структуру, выделенную клиентом SERIAL_XOFF_COUNTER, которая используется для ввода сведений счетчика XOFF.
Длина входного буфера
Параметр Parameters.DeviceIoControl.InputBufferLength имеет размер в байтах структуры SERIAL_XOFF_COUNTER.
Выходной буфер
Нет.
Длина выходного буфера
Нет.
Блок состояния
Элемент Information имеет значение 0.
Для элемента Status задано одно из универсальных значений состояния для запросов на управление последовательным устройством или одно из следующих значений, относящихся к запросу:
STATUS_INVALID_PARAMETER
Значение счетчика, указанное для запроса счетчика XOFF, меньше нуля.
STATUS_SERIAL_COUNTER_TIMEOUT
Истек срок действия запроса.
STATUS_SERIAL_MORE_WRITES
Получен запрос на запись.
Требования
| Требование | Значение |
|---|---|
| Заголовок | ntddser.h (включая Ntddser.h) |