winnt.h) (TAPE_SET_POSITION 结构

TAPE_SET_POSITION结构描述磁带的放置方式和位置。

语法

typedef struct _TAPE_SET_POSITION {
  DWORD         Method;
  DWORD         Partition;
  LARGE_INTEGER Offset;
  BOOLEAN       Immediate;
} TAPE_SET_POSITION, *PTAPE_SET_POSITION;

成员

Method

定位类型。 此成员必须是以下值之一。

值	含义
TAPE_ABSOLUTE_BLOCK 1L	将磁带移动到 由 Offset 成员指定的特定于设备的块地址。 将忽略 Partition 成员。
TAPE_LOGICAL_BLOCK 2L	将磁带移动到 Partition 指定的分区中 Offset指定的块地址。
TAPE_REWIND 0L	将磁带移动到当前分区的开头。 将忽略 Partition 和 Offset 成员。
TAPE_SPACE_END_OF_DATA 4L	将磁带移到 Partition 指定的分区上的数据的末尾。
TAPE_SPACE_FILEMARKS 6L	将磁带向前移动 (或向后移动) 当前分区中 Offset 指定的文件标记数。 将忽略 Partition 成员。
TAPE_SPACE_RELATIVE_BLOCKS 5L	将磁带向前移动 (或向后移动，) 当前分区中的 Offset 指定的块数。 将忽略 Partition 成员。
TAPE_SPACE_SEQUENTIAL_FMKS 7L	将磁带向前移动 (或向后移动) 到当前分区中第一个出现的 n 个文件标记，其中 n 是由 Offset 指定的数字。 将忽略 Partition 参数。
TAPE_SPACE_SEQUENTIAL_SMKS 9L	将磁带向前移动 (或向后移动) 到当前分区中第一个出现的 n 组标记，其中 n 是由 Offset 指定的数字。 将忽略 Partition 成员。
TAPE_SPACE_SETMARKS 8L	将磁带向前移动 (或向后移动，) 当前分区中的 Offset 指定的设置标记数。 将忽略 Partition 成员。

Partition

要在其中定位的分区。 如果此成员为零，则假定为当前分区。

Offset

方法成员指定的位置操作的阻止地址或计数。

Immediate

如果此成员为 TRUE，则操作开始后立即返回 。 否则，在操作完成后返回 。

注解

如果定位是相对的，则正偏移量将磁带向前 (向磁带) 的末端移动，负偏移将磁带向后 (向磁带) 的开头移动。

要求

要求	值
最低受支持的客户端	Windows XP [仅限桌面应用]
最低受支持的服务器	Windows Server 2003 [仅限桌面应用]
标头	winnt.h (包括 Windows.h)