IOCTL_TAPE_SET_POSITION IOCTL (ntddtape.h)

Moves the current position on the tape to the specified partition and offset, according to the given method.

Major code

IRP_MJ_DEVICE_CONTROL

Input buffer

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

The TAPE_SET_POSITION structure in the buffer at Irp->AssociatedIrp.SystemBuffer indicates the partition and offset to which the tape is to be moved.

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_SET_POSITION).

Output buffer

None.

Output buffer length

None.

Status block

The Information field is set to zero. 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_NO_MEDIA_IN_DEVICE, or STATUS_VERIFY_REQUIRED.

Requirements

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

See also

TAPE_SET_POSITION

TAPE_STATUS

TapeMiniSetPosition