TAPE_STATUS enumeration (minitape.h)

The TAPE_STATUS enumeration provides a list of the status codes that the tape class driver uses to report the status of a tape device.

Syntax

typedef enum _TAPE_STATUS {
  TAPE_STATUS_SEND_SRB_AND_CALLBACK,
  TAPE_STATUS_CALLBACK,
  TAPE_STATUS_CHECK_TEST_UNIT_READY,
  TAPE_STATUS_SUCCESS,
  TAPE_STATUS_INSUFFICIENT_RESOURCES,
  TAPE_STATUS_NOT_IMPLEMENTED,
  TAPE_STATUS_INVALID_DEVICE_REQUEST,
  TAPE_STATUS_INVALID_PARAMETER,
  TAPE_STATUS_MEDIA_CHANGED,
  TAPE_STATUS_BUS_RESET,
  TAPE_STATUS_SETMARK_DETECTED,
  TAPE_STATUS_FILEMARK_DETECTED,
  TAPE_STATUS_BEGINNING_OF_MEDIA,
  TAPE_STATUS_END_OF_MEDIA,
  TAPE_STATUS_BUFFER_OVERFLOW,
  TAPE_STATUS_NO_DATA_DETECTED,
  TAPE_STATUS_EOM_OVERFLOW,
  TAPE_STATUS_NO_MEDIA,
  TAPE_STATUS_IO_DEVICE_ERROR,
  TAPE_STATUS_UNRECOGNIZED_MEDIA,
  TAPE_STATUS_DEVICE_NOT_READY,
  TAPE_STATUS_MEDIA_WRITE_PROTECTED,
  TAPE_STATUS_DEVICE_DATA_ERROR,
  TAPE_STATUS_NO_SUCH_DEVICE,
  TAPE_STATUS_INVALID_BLOCK_LENGTH,
  TAPE_STATUS_IO_TIMEOUT,
  TAPE_STATUS_DEVICE_NOT_CONNECTED,
  TAPE_STATUS_DATA_OVERRUN,
  TAPE_STATUS_DEVICE_BUSY,
  TAPE_STATUS_REQUIRES_CLEANING,
  TAPE_STATUS_CLEANER_CARTRIDGE_INSTALLED
} TAPE_STATUS, *PTAPE_STATUS;

Constants

TAPE_STATUS_SEND_SRB_AND_CALLBACK Directs the tape class driver to send the SRB to the device. A tape miniclass routine usually returns this status after filling in the SRB passed by the tape class driver. If the operation is successful, the class driver increments a counter called a "call number" and calls the miniclass routine again. If the SRB fails, the class driver might call the miniclass routine again. For more information about how and when tape miniclass drivers should report this status value, see Processing Tape Device Control Requests.
TAPE_STATUS_CALLBACK Directs the tape class driver to increment the call number counter without sending an SRB to the device. For more information about how tape miniclass drivers should make use of this status value, see Processing Tape Device Control Requests.
TAPE_STATUS_CHECK_TEST_UNIT_READY Directs the tape class driver to create an SRB for the TEST UNIT READY command and to send the SRB to the device.
TAPE_STATUS_SUCCESS Indicates that the operation was successful.
TAPE_STATUS_INSUFFICIENT_RESOURCES Indicates that there were not enough resources available to the miniclass driver for it to complete the operation.
TAPE_STATUS_NOT_IMPLEMENTED Indicates that the requested operation is not supported.
TAPE_STATUS_INVALID_DEVICE_REQUEST Indicates that the requested operation is invalid.
TAPE_STATUS_INVALID_PARAMETER Indicates that one or more of the parameter values provided with the request are invalid.
TAPE_STATUS_MEDIA_CHANGED Indicates that the media in the drive might have changed.
TAPE_STATUS_BUS_RESET Indicates that the bus has been reset.
TAPE_STATUS_SETMARK_DETECTED Indicates that a setmark was encountered during a tape operation.
TAPE_STATUS_FILEMARK_DETECTED Indicates that a filemark was encountered during a tape operation.
TAPE_STATUS_BEGINNING_OF_MEDIA Indicates that the beginning of the media was encountered during a tape operation.
TAPE_STATUS_END_OF_MEDIA Indicates that the end of the media was encountered during a tape operation.
TAPE_STATUS_BUFFER_OVERFLOW Indicates that a buffer overflow occurred.
TAPE_STATUS_NO_DATA_DETECTED Indicates that no data was detected.
TAPE_STATUS_EOM_OVERFLOW Indicates that an attempt was made to exceed the physical end of the media during a tape operation.
TAPE_STATUS_NO_MEDIA Indicates that the tape operation failed, because there is no media in the drive.
TAPE_STATUS_IO_DEVICE_ERROR Indicates that an I/O error occurred during a tape operation.
TAPE_STATUS_UNRECOGNIZED_MEDIA Indicates that the type of the media is not supported.
TAPE_STATUS_DEVICE_NOT_READY Indicates that the device is not ready.
TAPE_STATUS_MEDIA_WRITE_PROTECTED Indicates that the media is write protected.
TAPE_STATUS_DEVICE_DATA_ERROR Indicates that a cyclic redundancy check (CRC) error occurred.
TAPE_STATUS_NO_SUCH_DEVICE Indicates that no such device exists.
TAPE_STATUS_INVALID_BLOCK_LENGTH Indicates that the block length is invalid.
TAPE_STATUS_IO_TIMEOUT Indicates that the I/O operation timed out.
TAPE_STATUS_DEVICE_NOT_CONNECTED Indicates that the device is disconnected.
TAPE_STATUS_DATA_OVERRUN Indicates that the tape operation could not be performed because of a data overrun.
TAPE_STATUS_DEVICE_BUSY Indicates that the tape operation could not be performed, because the device is busy.
TAPE_STATUS_REQUIRES_CLEANING Indicates that the tape operation could not be performed because the device requires cleaning.
TAPE_STATUS_CLEANER_CARTRIDGE_INSTALLED Indicates that the media currently in the drive is a cleaner cartridge.

Requirements

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

See also

IOCTL_TAPE_GET_STATUS