TAPE_GET_DRIVE_PARAMETERS 構造体 (ntddtape.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 デバイスでは、setmark レポートがサポートされています。
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

TAPE_DRIVE_HIGH_FEATURESが FeaturesLow に設定されている場合に、このドライブでサポートされる追加 機能を示します。 ミニポート ドライバーは、ドライブでサポートされている機能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 ntddtape.h (Ntddtape.h、Minitape.h を含む)

こちらもご覧ください

IOCTL_TAPE_GET_DRIVE_PARAMS

TapeMiniGetDriveParameters