TAPE_SET_POSITION 構造体 (winnt.h)

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

内に配置するパーティション。 このメンバーが 0 の場合、現在のパーティションが想定されます。

Offset

Method メンバーによって指定された位置操作のブロック アドレスまたはカウント。

Immediate

このメンバーが TRUE の場合は、操作が開始されるとすぐに を返します。 それ以外の場合は、操作が完了した後に を返します。

注釈

位置が相対位置の場合、正のオフセットを指定するとテープが前方 (テープの末尾に向かって) 移動し、負のオフセットはテープを (テープの先頭に向かって) 後方に移動します。

要件

要件 値
サポートされている最小のクライアント Windows XP (デスクトップ アプリのみ)
サポートされている最小のサーバー Windows Server 2003 (デスクトップ アプリのみ)
Header winnt.h (Windows.h を含む)