The IOCTL_SERIAL_XOFF_COUNTER request sets an XOFF counter. An XOFF counter request supports clients that use software to emulate hardware handshake flow control.

An XOFF counter request is synchronized with write requests. The driver sends a specified XOFF character, and completes the request after one of the following events occurs:

  • A write request is received.

  • A timer expires (a time-out value is specified by the XOFF counter request).

  • The serial controller driver receives a number of characters that is greater than or equal to a count specified by the XOFF counter request.

For more information about the operation of an XOFF counter, see the description of the SERIAL_XOFF_COUNTER structure in the Ntddser.h header file in the Microsoft Windows Driver Kit (WDK).

Major Code


Input Buffer

The AssociatedIrp.SystemBuffer points to a client-allocated SERIAL_XOFF_COUNTER structure that is used to input XOFF counter information.

Input Buffer Length

The Parameters.DeviceIoControl.InputBufferLength is set to the size, in bytes, of a SERIAL_XOFF_COUNTER structure.

Output Buffer


Output Buffer Length


Input / Output Buffer

Input / Output Buffer Length

Status Block

The Information member is set to zero.

The Status member is set to one of the Generic Status Values for Serial Device Control Requests or to one of the following request-specific values:


Header ntddser.h (include Ntddser.h)

See Also



Send comments about this topic to Microsoft