Windows Driver Kit: Serial Devices
IRP_MJ_SET_INFORMATION (Serial)

The IRP_MJ_SET_INFORMATION request sets the end-of-file information about a serial device.

When Sent

A client uses a set information request to change the current end-of-file position of a file opened on a serial device.

Input Parameters

The Parameters.SetFile.FileInformationClass member is set to FileEndOfFileInformation or FileAllocationInformation.

Output Parameters

None.

I/O Status Block

If the request is successful, the Information member is set to zero.

The Status member is set to one of the following status values:

STATUS_SUCCESS
The request completed successfully.
STATUS_CANCELLED
A client canceled the request. Serial also cancels a request if a device error occurs and Serial is configured to cancel a request if there is a device error.
STATUS_DELETE_PENDING
Serial is in the process of removing the device.
STATUS_INVALID_PARAMETER
The specified end-of-file information is not supported.
STATUS_PENDING
Serial queued the request for later processing.

Operation

Serial supports requests of type FileEndOfFileInformation and FileAllocationInformation. However, Serial does not actually set file information. The end-of-file position is always set to zero.

Requirements

Headers: Defined in wdm.h. Include wdm.h or ntddk.h.

See Also

IRP_MJ_QUERY_INFORMATION (Serial)


Send feedback on this topic
Built on November 19, 2009
Page view tracker