Поделиться через

IOCTL_SERIAL_XOFF_COUNTER IOCTL (ntddser.h)

  • Статья

Запрос IOCTL_SERIAL_XOFF_COUNTER задает счетчик XOFF. Запрос счетчика XOFF поддерживает клиенты, использующие программное обеспечение для эмуляции управления потоком подтверждения оборудования.

Запрос счетчика XOFF синхронизируется с запросами на запись. Драйвер отправляет указанный символ XOFF и завершает запрос после выполнения одного из следующих событий:

  • Получается запрос на запись.
  • Истекает срок действия таймера (значение времени ожидания указывается запросом счетчика XOFF).
  • Драйвер последовательного контроллера получает число символов, превышающее или равное числу, заданному запросом счетчика XOFF.
Дополнительные сведения о работе счетчика XOFF см. в описании структуры SERIAL_XOFF_COUNTER в файле заголовка Ntddser.h в комплекте драйверов Microsoft Windows (WDK).

Основной код

IRP_MJ_DEVICE_CONTROL

Входной буфер

AssociatedIrp.SystemBuffer указывает на выделенную клиентом структуру SERIAL_XOFF_COUNTER, которая используется для ввода сведений о счетчике XOFF.

Длина входного буфера

Parameters.DeviceIoControl.InputBufferLength имеет размер в байтах структуры SERIAL_XOFF_COUNTER.

Выходной буфер

Никакой.

Длина выходного буфера

Никакой.

Блок состояния

Элемент Information имеет значение нулю.

Элемент состояния имеет одно из универсальных значений состояния для запросов последовательного управления устройствами или одно из следующих значений, относящихся к запросу:

STATUS_INVALID_PARAMETER

Значение счетчика, указанное для запроса счетчика XOFF, меньше нуля.

STATUS_SERIAL_COUNTER_TIMEOUT

Время ожидания запроса.

STATUS_SERIAL_MORE_WRITES

Получен запрос на запись.

Требования

Требование Ценность
заголовка ntddser.h (include Ntddser.h)

См. также

IOCTL_SERIAL_SET_XOFF

IOCTL_SERIAL_SET_XON