IOCTL_SERIAL_SET_CHARS IOCTL (ntddser.h)

The IOCTL_SERIAL_SET_CHARS request sets the special characters that the serial controller driver uses for handshake flow control. This driver verifies the specified special characters.

To obtain the special characters, a client can use an IOCTL_SERIAL_GET_CHARS request.

Major code

IRP_MJ_DEVICE_CONTROL

Input buffer

The AssociatedIrp.SystemBuffer member points to a client-allocated SERIAL_CHARS structure that is used to input special characters.

Input buffer length

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

Output buffer

None.

Output buffer length

None.

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. A status of STATUS_INVALID_PARAMETER indicates that XoffChar equals XonChar, or that one of them equals the handshake flow control escape character.

Requirements

Requirement Value
Header ntddser.h (include Ntddser.h)

See also

IOCTL_SERIAL_GET_CHARS

SERIAL_CHARS