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
テープの末尾に向かう早期警告ゾーンのサイズをバイト単位で示します。 デバイスがゾーンに入ると、チェック条件が返されます。
必要条件
| 要件 | 価値 |
|---|---|
| ヘッダー | minitape.h (Ntddtape.h、Minitape.h を含む) |