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