Edit

WINDOWS_BLOCK_DEVICE_TOKEN_LIMITS_DESCRIPTOR structure (minitape.h)

  • Article

The WINDOWS_BLOCK_DEVICE_TOKEN_LIMITS_DESCRIPTOR structure is the third party copy descriptor for Windows systems. This structure serves as the descriptor for the vital product data (VPD) third party copy page.

Syntax

typedef struct _WINDOWS_BLOCK_DEVICE_TOKEN_LIMITS_DESCRIPTOR {
  UCHAR DescriptorType[2];
  UCHAR DescriptorLength[2];
  UCHAR VendorSpecific[6];
  UCHAR MaximumRangeDescriptors[2];
  UCHAR MaximumInactivityTimer[4];
  UCHAR DefaultInactivityTimer[4];
  UCHAR MaximumTokenTransferSize[8];
  UCHAR OptimalTransferCount[8];
} WINDOWS_BLOCK_DEVICE_TOKEN_LIMITS_DESCRIPTOR, *PWINDOWS_BLOCK_DEVICE_TOKEN_LIMITS_DESCRIPTOR;

Members

DescriptorType[2]

The descriptor type identifying this structure. The descriptor type is defined in storport.h as BLOCK_DEVICE_TOKEN_LIMITS_DESCRIPTOR_TYPE_WINDOWS.

DescriptorLength[2]

The length of this structure starting with the VendorSpecific member.

VendorSpecific[6]

Vendor specific bytes included in the descriptor. Windows applications must treat this member as reserved and ignore the reported value.

MaximumRangeDescriptors[2]

The maximum number of range descriptors that may be included along with the POPULATE_TOKEN_HEADER or the WRITE_USING_TOKEN_HEADER structures.

MaximumInactivityTimer[4]

The maximum available to specify as the timeout value in the InactivityTimeout member of the POPULATE_TOKEN_HEADER structure.

DefaultInactivityTimer[4]

The default value that is used by the copy provider when the InactivityTimeout of the POPULATE_TOKEN_HEADER structure is set to 0.

MaximumTokenTransferSize[8]

The maximum number of logical blocks that can be specified as a total of the block range descriptors in the POPULATE_TOKEN_HEADER or the WRITE_USING_TOKEN_HEADER structures.

OptimalTransferCount[8]

The optimal number of logical blocks, as a maximum, to specify as a total of the block range descriptors in the POPULATE_TOKEN_HEADER or the WRITE_USING_TOKEN_HEADER structures. Offload data transfer performance may degrade if the transfer count is larger than this value.

Remarks

All multibyte values are in big endian format. Prior to evaluation, these values must be converted to match the endian format of the current platform.

Requirements

Requirement Value
Minimum supported client Available starting with Windows 8.
Header minitape.h (include Scsi.h, Minitape.h, Storport.h)

See also

POPULATE_TOKEN_HEADER

VPD_THIRD_PARTY_COPY_PAGE

WRITE_USING_TOKEN_HEADER