IOCTL_TAPE_PREPARE IOCTL (ntddtape.h)

Loads or unloads the tape, resets tape tension, locks or unlocks the ejection mechanism, or formats the tape.

Major code

IRP_MJ_DEVICE_CONTROL

Input buffer

The buffer at Irp->AssociatedIrp.SystemBuffer contains a TAPE_PREPARE structure that indicates the type of operation.

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

Output buffer

None.

Output buffer length

None.

Status block

The Information field is set to the number of bytes transferred. The Status field is set to STATUS_SUCCESS, or possibly to STATUS_NO_SUCH_DEVICE, STATUS_IO_TIMEOUT, STATUS_IO_DEVICE_ERROR, STATUS_INSUFFICIENT_RESOURCES, STATUS_DEVICE_NOT_CONNECTED, 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_PREPARE

TAPE_STATUS

TapeMiniPrepare