Oplock テスト
この自動化テストでは、レガシの便宜的ロック (oplock) と拡張 Oplock の基本的な動作を検証します。 レガシ Oplock は Level2 (L2)、Level1 (L1)、Filter、Batch です。 強化された oplocks は、読み取り (R)、読み書き (RW)、読み取り/ハンドル (RH)、読み取り/書き込みハンドル (RWH) です。
Note
ファイル システムの動作の詳細 (Oplock 等) については、「Microsoft Windows 環境でのファイル システムの動作」を参照してください。
テストでは、「テストの実行」セクションで説明した 6 つのパーティションそれぞれに対して、バリエーションが実行されます。
このテストには、次のバリエーションがあります。
Legacy_Acquire_Release。 レガシ oplock を取得し、リリースします。
Enhanced_Acquire_Release。 拡張 oplock を取得し、リリースします。
Enhanced_Acquire_Release_Opkey。 oplock キーを使用して拡張 oplock を取得します。
Legacy_Break_L2。 さまざまなファイル操作で L2 oplock を中断します。
Enhanced_Break_R。 さまざまなファイル操作で R oplock を中断します。
Legacy_Break_L1。 さまざまなファイル操作で L1 oplock を中断します。
Enhanced_Break_RW。 さまざまなファイル操作で RW oplock を中断します。
Enhanced_Break_RH。 さまざまなファイル操作で RH oplock を中断します。
Legacy_Break_Batch。 さまざまなファイル操作でバッチ oplock を中断します。
Enhanced_Break_RWH。 さまざまなファイル操作で RWH oplock を中断します。
EnhancedMultipleSharedOplocks。 同じファイルで複数の拡張 oplock を取得します。
EnhancedUpgradeOplocks。 拡張 oplock をアップグレードします。
EnhancedOplockBreakAckOtherHandle。 同じキーを使用して開いた別のハンドルで、拡張 oplock の中断を確認します。
EnhancedOplockStealthUpgrade。 oplock の中断を確認し、アップグレード レベルの oplock を要求します。
AtomicOplocksVariation。 アトミック オープン (CreatOptions=FILE_OPEN_REQUIRING_OPLOCK を使用してハンドルを開きます)。
AtomicOplocksNonIntrusiveVariation。 ファイルに oplock が既に存在する場合はアトミックに開きます。
BreakingRHOplocks。 RH oplock を中断する特別な操作を実行します。
テストの詳細
| 仕様 |
|
| プラットフォーム |
|
| サポートされているリリース |
|
| 予想される実行時間 (分) | 540 |
| カテゴリ | 開発 |
| タイムアウト (分) | 32400 |
| 再起動が必要です | false |
| 特別な構成が必要です | false |
| Type | automatic |
その他のドキュメント
この機能領域のテストには、前提条件、セットアップ、トラブルシューティング情報など、次のトピックに記載されている追加のドキュメントが含まれている場合があります。
テストの実行
要件の詳細については、「ファイル システムのテストの前提条件」を参照してください。
さらに、このテストでは、以下のように 4 つのシンプルな 2,048 メガバイト (MB) パーティションと、2 つのシンプルな 1,024 MB パーティション用の追加のハード ドライブ領域が必要です。
テストを実行する前に、次のパーティションを追加する必要があります。
| Label | ファイル システム | サイズ | 期待されるドライブ文字 |
|---|---|---|---|
NTFS |
NTFS |
2,048 MB |
g: |
CNTFS |
NTFS (圧縮) |
2,048 MB |
i: |
FAT |
FAT16 |
1,024 MB |
k: |
FAT32 |
FAT32 |
1,024 MB |
l: |
ExFAT |
ExFAT |
2,048 MB |
m: |
UDF |
UDF |
2,048 MB |
n: |
REFS |
REFS |
10240mb |
o: |
Note
RunFileIO.cmd には、特定のファイル システムのスキップを可能にするために変更できる環境変数への参照が含まれています。
トラブルシューティング
HLK テスト エラーの一般的なトラブルシューティングについては、「Windows HLK テストのエラーのトラブルシューティング」を参照してください。
トラブルシューティング情報については、「ファイル システム テストのトラブルシューティング」を参照してください。
すべてのテスト ケースで成功または失敗が返されます。 テスト ケースの詳細は、Windows Hardware Lab Kit (Windows HLK) Studio のテスト ログで確認します。
このテストを実行するには、コンピューターに NTFS、CNTFS、FAT16、FAT32、ExFAT、UDF ボリュームが設定されている必要があります。 また、このボリュームのドライブ文字が <filesystem>_DRIVE_LETTER パラメーターに入力されていることを確認してください。
詳細
コマンド構文
| コマンド オプション | 説明 |
|---|---|
runkarr %DRIVE_1% %DRIVE_2% -bvt |
2 つのドライブ文字と bvt パラメーターが必要です。 |
Note
このテスト バイナリのコマンド ライン ヘルプを表示するには、「/h」と入力します。
ファイル一覧
| ファイル | インストール先 |
|---|---|
Enhancedoplocks.exe |
<[testbinroot]>\NTTest\BASETEST\core_file_services\Shared_Tests\Regression\Oplocks\ |
Opkey.inf |
<[testbinroot]>\NTTest\BASETEST\core_file_services\FilterManager\ |
Opkey.sys |
<[testbinroot]>\NTTest\BASETEST\core_file_services\FilterManager\ |
RunOplocks.cmd |
<[testbinroot]>\NTTest\BASETEST\Core_File_Services\FilterManager\TestSuite\Scripts\FileSystems\ |
WrapOplocks.cmd |
<[testbinroot]>\NTTest\BASETEST\Core_File_Services\FilterManager\TestSuite\Scripts\FileSystems\ |
パラメーター
| パラメーター名 | パラメーターの説明 |
|---|---|
| NTFS_DRIVE_LETTER | Oplocks テストが実行される NTFS ボリュームのドライブ文字。 |
| CNTFS_DRIVE_LETTER | Oplocks テストが実行される圧縮 NTFS ボリュームのドライブ文字。 |
| FAT_DRIVE_LETTER | Oplocks テストが実行される FAT ボリュームのドライブ文字。 |
| FAT32_DRIVE_LETTER | Oplocks テストが実行される Fat32 ボリュームのドライブ文字。 |
| EXFAT_DRIVE_LETTER | Oplocks テストが実行される ExFat ボリュームのドライブ文字。 |
| UDF_DRIVE_LETTER | Oplocks テストが実行される UDF ボリュームのドライブ文字。 |
| LLU_LclAdminUSer | 実行用の LLU |
| LLU_NetAccessOnly | コピー用 LLU |
| REFS_DRIVE_LETTER | テストを実行する ReFS ボリュームのドライブ文字。 >= Win8 Server でない場合は、NONE を入力します。 |