Edit

TAPE_SET_DRIVE_PARAMETERS structure (minitape.h)

  • Article

The TAPE_SET_DRIVE_PARAMETERS structure is used in conjunction with the IOCTL_TAPE_SET_DRIVE_PARAMS request to adjust the configurable parameters of a tape drive.

Syntax

typedef struct _TAPE_SET_DRIVE_PARAMETERS {
  BOOLEAN ECC;
  BOOLEAN Compression;
  BOOLEAN DataPadding;
  BOOLEAN ReportSetmarks;
  ULONG   EOTWarningZoneSize;
} TAPE_SET_DRIVE_PARAMETERS, *PTAPE_SET_DRIVE_PARAMETERS;

Members

ECC

When set to TRUE, instructs the device to use hardware error correction. When FALSE, the device does not use hardware error correction.

Compression

When set to TRUE, instructs the device to compress data prior to writing it. If a drive must be at beginning of partition before it can set compression (TAPE_DRIVE_SET_CMP_BOP_ONLY), the caller is responsible for positioning the drive before attempting to set compression. When FALSE, the device does not compress data prior to writing it.

DataPadding

When set to TRUE, instructs the device to pad data with zeros. This is to keep the tape streaming until data is ready. When FALSE, the device does not pad data with zeros.

ReportSetmarks

When set to TRUE, instructs the device to report setmarks encountered during read or space operations. When FALSE, the device does not report setmarks encountered during read or space operations.

EOTWarningZoneSize

Indicates the size in bytes of the early warning zone toward the end of the tape in which the drive returns a check condition when it enters the zone.

Remarks

The miniclass driver can ignore parameters its device does not support. The calling application is responsible for determining whether a device supports a particular feature before attempting to set it.

Requirements

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

See also

IOCTL_TAPE_SET_DRIVE_PARAMS

TapeMiniSetDriveParameters