TAPE_GET_DRIVE_PARAMETERS構造体 (minitape.h)

  • [アーティクル]

TAPE_GET_DRIVE_PARAMETERS構造体は、テープ・ドライブの機能に関する情報を取得するために 、IOCTL_TAPE_GET_DRIVE_PARAMS 要求と組み合わせて使用されます。

構文

typedef struct _TAPE_GET_DRIVE_PARAMETERS {
  BOOLEAN ECC;
  BOOLEAN Compression;
  BOOLEAN DataPadding;
  BOOLEAN ReportSetmarks;
  ULONG   DefaultBlockSize;
  ULONG   MaximumBlockSize;
  ULONG   MinimumBlockSize;
  ULONG   MaximumPartitionCount;
  ULONG   FeaturesLow;
  ULONG   FeaturesHigh;
  ULONG   EOTWarningZoneSize;
} TAPE_GET_DRIVE_PARAMETERS, *PTAPE_GET_DRIVE_PARAMETERS;

メンバー

ECC

TRUE に設定すると、デバイスでハードウェア エラー修正が使用されることを示します。

Compression

TRUE に設定すると、圧縮をサポートするデバイスで圧縮が有効になっていることを示します。 圧縮が有効になっている場合、デバイスはデータを書き込む前に圧縮します。 FALSE に設定すると、デバイスで圧縮は有効になりません。

DataPadding

TRUE に設定すると、データ埋め込みがサポートされているデバイスで有効になっていることを示します。 パディングが有効になっている場合、デバイスはデータをゼロで埋め込み、データの準備ができるまでテープ ストリーミングを維持します。 FALSE に設定すると、データの埋め込みは有効になりません。

ReportSetmarks

TRUE に設定すると、それをサポートするデバイスでレポート設定マークが有効になっていることを示します。 デバイスは、読み取り操作またはスペース操作中に検出された設定マークを報告します。 FALSE に設定すると、レポートの設定マークは有効になりません。

DefaultBlockSize

既定のブロック サイズをバイト単位で示します。

MaximumBlockSize

テープ デバイスまたは基になるホスト バス アダプター (HBA) のいずれか小さい方の最大ブロック サイズをバイト単位で示します。

MinimumBlockSize

最小ブロック サイズ (バイト単位) を示します。

MaximumPartitionCount

デバイスがサポートするパーティションの最大数を示します。

FeaturesLow

このドライブでサポートされている機能を示します。 ミニポート ドライバーは、ドライブでサポートされている機能のTAPE_DRIVE_XXX フラグを設定し、サポートされていない機能のフラグをクリアします。 呼び出し元は、minitape.h で定義されているTAPE_DRIVE_XXX マスクを使用して、ドライブが特定の機能をサポートしているかどうかを判断できます。 使用できるマスクは次のとおりです。

マスク 意味
TAPE_DRIVE_CLEAN_REQUESTS デバイスは、クリーニングが必要かどうかを報告できます。
TAPE_DRIVE_COMPRESSION デバイスでは、ハードウェア データ圧縮がサポートされています。
TAPE_DRIVE_ECC デバイスでは、ハードウェア エラーの修正がサポートされています。
TAPE_DRIVE_EJECT_MEDIA デバイスがメディアを取り出します。
TAPE_DRIVE_EOT_WZ_SIZE デバイスは、ゾーンの警告サイズの終了を報告できます。
TAPE_DRIVE_ERASE_BOP_ONLY デバイスは、パーティションの先頭マーカーからのみ消去操作を実行します。
TAPE_DRIVE_ERASE_IMMEDIATE デバイスは即時消去操作を実行しますか? つまり、消去操作の開始時に が返されます。
TAPE_DRIVE_ERASE_LONG デバイスは長い消去操作を実行します。
TAPE_DRIVE_ERASE_SHORT デバイスは短い消去操作を実行します。
TAPE_DRIVE_FIXED デバイスによって固定データ パーティションが作成されます。
TAPE_DRIVE_FIXED_BLOCK デバイスは固定長ブロック モードをサポートしています。
TAPE_DRIVE_INITIATOR デバイスは、イニシエーター定義パーティションを作成します。
TAPE_DRIVE_GET_ABSOLUTE_BLK デバイスは、現在のデバイス固有のブロック アドレスを提供します。
TAPE_DRIVE_GET_LOGICAL_BLK デバイスは、現在の論理ブロック アドレス (および論理テープ パーティション) を提供します。
TAPE_DRIVE_PADDING デバイスでは、データの埋め込みがサポートされています。
TAPE_DRIVE_REPORT_SMKS デバイスでは、設定マーク レポートがサポートされています。
TAPE_DRIVE_RESERVED_BIT 予約済みビットを識別するマスク。 ドライバーは、このビットを設定することはできません。
TAPE_DRIVE_SELECT デバイスによって選択されたデータ パーティションが作成されます。
TAPE_DRIVE_SET_CMP_BOP_ONLY デバイスでは、読み取り/書き込みヘッドがパーティションの先頭にある場合にのみ、圧縮を有効にすることができます。
TAPE_DRIVE_SET_EOT_WZ_SIZE デバイスは、中程度の警告サイズの設定をサポートしています。
TAPE_DRIVE_TAPE_CAPACITY デバイスは、テープの最大容量を返します。
TAPE_DRIVE_TAPE_REMAINING デバイスは、テープの残りの容量を返します。
TAPE_DRIVE_VARIABLE_BLOCK デバイスは可変長ブロック モードをサポートしています。
TAPE_DRIVE_WRITE_PROTECT テープが書き込み可能または書き込みで保護されている場合、デバイスはエラーを返します。

FeaturesHigh

FeaturesLow でTAPE_DRIVE_HIGH_FEATURESが設定されている場合に、このドライブでサポートされる追加機能を示します。 ミニポート ドライバーは、ドライブでサポートされている機能のTAPE_DRIVE_XXX フラグを設定し、サポートされていない機能のフラグをクリアします。 呼び出し元は、minitape.h で定義されているTAPE_DRIVE_XXX マスクを使用して、ドライブが特定の機能をサポートしているかどうかを判断できます。

マスク 意味
TAPE_DRIVE_ABS_BLK_IMMED デバイスはテープをデバイス固有のブロック アドレスに移動し、移動が開始されるとすぐに を返します。
TAPE_DRIVE_ABSOLUTE_BLK デバイスは、テープをデバイス固有のブロック アドレスに移動します。
TAPE_DRIVE_END_OF_DATA デバイスは、テープをパーティション内のデータの末尾マーカーに移動します。
TAPE_DRIVE_FILEMARKS デバイスは、指定された数のファイル マークをテープを前方 (または後方) に移動します。
TAPE_DRIVE_FORMAT デバイスはメディアをフォーマットできます。
TAPE_DRIVE_FORMAT_IMMEDIATE デバイスは、メディアを即時コマンドとして書式設定できます。
TAPE_DRIVE_HIGH_FEATURES 高い機能に対応するビットを示すビットマスク。
TAPE_DRIVE_LOAD_UNLOAD デバイスは、追加の操作のためにデバイスを有効および無効にします。
TAPE_DRIVE_LOAD_UNLD_IMMED デバイスは、即時の読み込みとアンロード操作をサポートします。
TAPE_DRIVE_LOCK_UNLOCK 装置はテープ排出メカニズムを有効にし、無効にする。
TAPE_DRIVE_LOCK_UNLK_IMMED デバイスは、即時ロックおよびロック解除操作をサポートします。
TAPE_DRIVE_LOG_BLK_IMMED デバイスは、テープをパーティション内の論理ブロック アドレスに移動し、移動が開始されるとすぐに を返します。
TAPE_DRIVE_LOGICAL_BLK デバイスは、テープをパーティション内の論理ブロック アドレスに移動します。
TAPE_DRIVE_RELATIVE_BLKS デバイスは、指定された数のブロックをテープを前方 (または後方) に移動します。
TAPE_DRIVE_REVERSE_POSITION デバイスは、ブロック、ファイル マーク、または設定マークの上にテープを後方に移動します。
TAPE_DRIVE_REWIND_IMMEDIATE デバイスは、即時巻き戻し操作をサポートします。
TAPE_DRIVE_SEQUENTIAL_FMKS デバイスは、テープを前方 (または後方) に移動し、指定された数の連続するファイル マークが最初に出現します。
TAPE_DRIVE_SEQUENTIAL_SMKS デバイスは、テープを前方 (または後方) に移動し、指定された数の連続するマークが最初に出現します。
TAPE_DRIVE_SET_BLOCK_SIZE デバイスでは、固定長論理ブロックのサイズの設定または可変長ブロック モードの設定がサポートされています。
TAPE_DRIVE_SET_COMPRESSION デバイスは、ハードウェア データ圧縮を有効または無効にします。
TAPE_DRIVE_SET_ECC デバイスは、ハードウェア エラーの修正を有効または無効にします。
TAPE_DRIVE_SET_PADDING デバイスは、データの埋め込みを有効または無効にします。
TAPE_DRIVE_SET_REPORT_SMKS デバイスは、設定マークのレポートを有効または無効にします。
TAPE_DRIVE_SETMARKS デバイスは、指定された数の設定マークをテープを前方 (または逆) に移動します。
TAPE_DRIVE_SPACE_IMMEDIATE デバイスは、即時間隔をサポートします。
TAPE_DRIVE_TENSION 装置はテープ張力を支える。
TAPE_DRIVE_TENSION_IMMED 装置は即時テープ張力を支える。
TAPE_DRIVE_WRITE_FILEMARKS デバイスがファイル マークを書き込みます。
TAPE_DRIVE_WRITE_LONG_FMKS デバイスは長いファイルマークを書き込みます。
TAPE_DRIVE_WRITE_MARK_IMMED このデバイスでは、短いファイルマークと長いファイルマークの即時書き込みがサポートされています。
TAPE_DRIVE_WRITE_SETMARKS デバイスが設定マークを書き込みます。
TAPE_DRIVE_WRITE_SHORT_FMKS デバイスは短いファイルマークを書き込みます。

EOTWarningZoneSize

テープの末尾に向かう早期警告ゾーンのサイズをバイト単位で示します。 デバイスは、ゾーンに入るとチェック条件を返します。

要件

要件 値
Header minitape.h (Ntddtape.h、Minitape.h を含む)

こちらもご覧ください

IOCTL_TAPE_GET_DRIVE_PARAMS

TapeMiniGetDriveParameters