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 を含む) |