IOCTL_TAPE_WRITE_MARKS IOCTL (ntddtape.h)

Writes one of setmarks, filemarks, short filemarks, or long filemarks to tape.

Major code

IRP_MJ_DEVICE_CONTROL

Input buffer

The TAPE_WRITE_MARKS structure in the buffer at Irp->AssociatedIrp.SystemBuffer indicates the type and number of marks to write.

If the Immediate member is TRUE, the operation should be asynchronous.

Input buffer length

Parameters.DeviceIoControl.InputBufferLength in the I/O stack location indicates the size, in bytes, of the parameter buffer, which must be >= sizeof(TAPE_WRITE_MARKS).

Output buffer

None.

Output buffer length

None.

Status block

The Information field is set to the number of bytes written. The Status field is set to STATUS_SUCCESS, or possibly to STATUS_INFO_LENGTH_MISMATCH, STATUS_IO_DEVICE_ERROR, STATUS_DEVICE_DATA_ERROR, STATUS_NO_SUCH_DEVICE, STATUS_IO_TIMEOUT, STATUS_DEVICE_NOT_READY, STATUS_MEDIA_WRITE_PROTECTED, STATUS_NO_MEDIA_IN_DEVICE, or STATUS_VERIFY_REQUIRED.

Requirements

Requirement Value
Header ntddtape.h (include Ntddtape.h)

See also

TAPE_STATUS

TAPE_WRITE_MARKS

TapeMiniWriteMarks