TapeClassPhysicalBlockToLogicalBlock function (minitape.h)

Article
10/21/2021

The TapeClassPhysicalBlockToLogicalBlock routine translates a physical block address to a pseudological block address. This routine is for SCSI-1 devices.

Syntax

ULONG TapeClassPhysicalBlockToLogicalBlock(
  [in] UCHAR   DensityCode,
  [in] ULONG   PhysicalBlockAddress,
  [in] ULONG   BlockLength,
  [in] BOOLEAN FromBOT
);

Parameters

[in] DensityCode

Specifies the tape media density code. This routine supports tapes with the following density codes: QIC_24, QIC_120, QIC_150, QIC_525, QIC_1000, QIC_2GB, QIC_1350, and QIC_2100.

[in] PhysicalBlockAddress

Specifies the physical block address obtained by a SCSI READ POSITION command.

[in] BlockLength

Specifies the logical block size, in bytes.

[in] FromBOT

TRUE indicates that the logical block calculation should start at the beginning of the tape and account for the physical device header. FALSE indicates that the tape has two partitions, that the block address is on the directory partition, and therefore no physical device header needs to be factored into the calculation.

Return value

TapeClassPhysicalBlockToLogicalBlock returns the logical block address.

Remarks

A tape miniclass driver calls TapeClassPhysicalBlockToLogicalBlock to translate a physical block address from a tape device to a logical block address for an application. TapeClassPhysicalBlockToLogicalBlock is not necessary for SCSI-2 or later drivers because devices that comply with SCSI-2 or later standards support logical block addressing.

If a tape miniclass driver calls this routine with an unsupported tape density code, TapeClassPhysicalBlockToLogicalBlock returns the physical block address in the return value, without performing any translation.

Requirements

Requirement	Value
Target Platform	Desktop
Header	minitape.h (include Minitape.h)
Library	Tape.lib