次の方法で共有

Rapidfile テスト (システム)

  • [アーティクル]

このテストは、指定されたボリュームまたはファイルに対してデータ整合性テストを実行します。

テストの詳細

   
仕様
  • System.Fundamentals.StorageAndBoot.BootPerformance
プラットフォーム
  • Windows 10、クライアント エディション (x86)
  • Windows 10、クライアント エディション (x64)
  • Windows 10、クライアント エディション (Arm64)
サポートされているリリース
  • Windows 10
  • Windows 10 バージョン 1511
  • Windows 10 Version 1607
  • Windows 10 Version 1703
  • Windows 10 バージョン 1709
  • Windows 10 バージョン 1803
  • Windows 10 Version 1809
  • Windows 10 バージョン 1903
  • Windows 10 への次の更新プログラム
予想される実行時間 (分) 30
カテゴリ シナリオ
タイムアウト (分) 1800
再起動が必要です false
特別な構成が必要です false
Type automatic

 

その他のドキュメント

この機能領域のテストには、前提条件、セットアップ、トラブルシューティング情報など、次のトピックに記載されている追加のドキュメントが含まれている場合があります。

テストの実行

テストを実行する前に、テスト要件: WDTF System Fundamentals のテストの前提条件に従って、テストのセットアップを完了してください。

テストを実行する前に、ボリューム パスが存在している必要があります。 ファイル パスを使用すると、テストの書き込みフェーズ/ステップ中にファイルが作成され、読み取り/検証フェーズで同じファイル パスが必要になります。

トラブルシューティング

HLK テスト エラーの一般的なトラブルシューティングについては、「Windows HLK テストのエラーのトラブルシューティング」を参照してください。

トラブルシューティング情報については、「System Fundamentals テストのトラブルシューティング」を参照してください。

このテストでは Pass (合格) または Fail (不合格) が返されます。 テストの詳細を確認するには、Windows Hardware Lab Kit (Windows HLK) Studio のテスト ログを確認します。

詳細情報

このテストは、ファイル システム/IO の動作に関連する多くのパラメーターを受け入れます。その一部について以下で説明します。

I/O 操作

  1. 書き込み これは、コマンド ラインで指定されたデバイス パスで実行される既定の操作です。

  2. 書き込み/検証 コマンド ラインで /V オプションが指定されている場合に読み取りを実行します。 特定の読み取り IO が完了した後、テストは、読み取りデータと (コマンド ラインで指定されたデバイス パスに基づいて) 予期されるデータを比較し、読み取りデータが予期されるデータと一致しない場合 (データの破損) をユーザーに通知します。

I/O モード

  1. 同期 /SYNC コマンド ライン オプションを指定すると、指定されたデバイス パス (ファイル/ボリューム) でテストによる I/O 要求は同期的に発行されます。 テストは、1 つの I/O の完了を待機してから別の I/O を発行します。 これは既定のオプションではありません。

  2. 非同期 /SYNC コマンド ライン オプションを指定しない場合、I/O 要求は非同期的に実行されます。この場合、テストは完了を待たずに一連の I/O 要求を発行します。 各 I/O 要求の完了は個別に追跡されます。 これがテストで使用される既定のモードです。

ファイル サイズ

ユーザーは、/Z コマンド ライン オプションを使用してカスタム ファイル サイズを指定できます。 ユーザーは、次のいずれかを追加して、さまざまなサイズを指定できます。

  1. K - KB の場合

  2. M - MB の場合

  3. G - GB の場合

  4. T - TB の場合

I/O の保留

非同期 I/O モードを使用する場合、ユーザーは、発行された I/O 要求の完了を待機する前に保留する I/O 要求の最大数を指定できます。 これは、/R <数値>コマンド ライン オプションを使用して実行できます。 たとえば「/R 1K」は、完了しない I/O 数が 1000 になるまで、テストが新しい I/O 要求を発行し続けるという意味です。

ファイル フラグ

テストは、指定されたパスで IO を開始する前に、FS API を使用してファイル ハンドルを作成します。 また、ユーザーは次のファイル フラグを使用してさまざまな IO パターンを作成できます。

  1. /FD - FILE_FLAG_DELETE_ON_CLOSE このオプションは、ファイルの最後のハンドルが閉じたら、指定されたファイルを削除する必要があることをそれぞれの FS に示します。 テストは、このフラグを読み取り/検証操作中にのみサポートします。

  2. /FS - FILE_FLAG_SEQUENTIAL_SCAN ファイル キャッシュを最適化するためのファイル システム フラグ。 これは、アクセスが最初から最後まで順番に実行されることを意図していることを示しています。 各ファイル システムがキャッシュされる I/O をサポートしない場合、このフラグには効果がありません。

  3. /FR - FILE_FLAG_RANDOM_ACCESS ファイル キャッシュを最適化するためのファイル システム フラグ。 これは、アクセスがランダムになることを意図していることを示しています。

  4. /FW - FILE_FLAG_WRITE_THROUGH 使用する場合、書き込み操作で中間キャッシュを使用せず、ディスクに直接提供されることになります。

  5. /FU - FILE_FLAG_NO_BUFFERING 使用する場合、ファイル システムに対して、ファイルまたはデバイスを開く際にデータの読み取りと書き込みにシステム キャッシュを使用しないよう指示します。

ブロック サイズ

テストは、指定されたブロック サイズで指定された I/O を実行します。 既定のブロック サイズ値は 64K です。 ユーザーは、/B コマンド ライン オプションを使用して、さまざまなブロック サイズを指定できます。

たとえば「/B 1M」は、1 MB の単一の I/O を実行するという意味です。

デバッグの中断

ユーザーがシステムにアタッチされた Windows デバッガーを使用してテストを実行している場合、/D コマンド ライン オプションを使用すると、テスト中に予期されるエラーが発生したときに、デバッガーに割り込む (および指定した状態でシステムをフリーズしたままにする) ように指示するために使用できます。 テストでは、これをヒントとして使用し、書き込みおよび読み取り/検証操作中に予期されるエラーを受け取った場合や、読み取り/検証操作中に読み取りデータが予期されるデータと一致しない場合にデバッガーに割り込みます。

コマンドの使用方法

コマンド 説明

rapidfile.exe test.dat /D /Z [FILE_SIZE] /R 16k

非同期書き込み

rapidfile.exe test.dat /V /D /FD /Z [FILE_SIZE] /R 16k

非同期読み取りの検証

rapidfile.exe test.dat /D /Z [FILE_SIZE] /SYNC

同期書き込み

rapidfile.exe test.dat /V /D /FD /Z [FILE_SIZE] /SYNC

同期読み取りの検証

rapidfile.exe test.dat /D /Z [FILE_SIZE] /FU /R 16K

非同期バッファー解除書き込み

rapidfile.exe test.dat /FU /V /D /FD /Z [FILE_SIZE] /R 16K

非同期バッファー解除読み取りの検証

rapidfile.exe test.dat /D /Z [FILE_SIZE] /FR /R 16K

ランダム アクセス非同期書き込み

rapidfile.exe test.dat /FR /V /D /FD /Z [FILE_SIZE] /R 16K

ランダム アクセス非同期読み取りの検証

 

コマンド構文

コマンド オプション 説明

rapidfile.exe

テスト用のコマンド ライン オプションを以下に示します。

/?

ヘルプを表示します。

/PERF

ファイル システム パフォーマンス データベースに結果のログを記録します。

/A

既存のファイルに追加します。

既定値: 追加しない

/B #

ブロック サイズ。 k、m、g、または t を追加できます。

既定値: 64k

/C

チェックサムを印刷します。 また、戻り値がチェックサムとなって終了します。

/CM

既定の圧縮形式でファイルを圧縮します。

/D

予期しないエラーが発生した場合、デバッガーに割り込みます。

/E #

読み取り/書き込みを発行する間に # ミリ秒スリープします。

/FD

FILE_FLAG_DELETE_ON_CLOSE (読み取り/検証操作でのみ有効)。

/FS

FILE_FLAG_SEQUENTIAL_SCAN

/FW

FILE_FLAG_WRITE_THROUGH

/FU

FILE_FLAG_NO_BUFFERING

/FR

FILE_FLAG_RANDOM_ACCESS

/H

ファイル ハンドルの代わりにディスクまたはボリューム デバイス ハンドルを作成します。

/I

アイドル優先度を使用します。

/L #

# 秒ごとに統計をログに記録します。

既定値: 60

/M #

テストを実行する時間 (分)。 これにより、書き込み後に読み取り/検証操作が実行されます。

/N

I/O ごとに新しいハンドルを使用します。

/NL

デバッガーにはログを何も記録しません。

/O

[既存のファイルの上書き]

/P #

パターンのサイズ。 k、m、g、または t を追加できます。

既定値: 4m

/R #

保留する要求の最大数。

/RT #

エラー時の再試行中のタイムアウト間隔 (ミリ秒単位)。 その他の形式は、秒、分、時間のそれぞれに対して #s、#m、#h です。

/S

I/O 操作に単純なパターンを使用します。

/SO

ディスクまたはボリューム デバイスの開始オフセット。

/SP

書き込む前に、ファイルをスパースにします。

/SYNC

ファイルに同期的に書き込みます (/TC /R は指定不可)。

/TC #

Completer スレッドの数。

既定値: 作成の場合は 1、検証の場合は 4

/TQ #

キューに入るスレッドの数。

既定値: 1

/V

ファイルを読み戻して検証します。

既定値: 検証しない

/X

作成後にファイルをフラッシュします。

/Z #

テスト ファイルのサイズ。 k、m、g、または t を追加できます。

既定値: 10m

/VDL #

書き込みを開始する前に VDL をプッシュする先の場所 (既定値 == 0、-1 == FileSize)。

/EOF #

書き込みを開始する前に EOF をプッシュする先の場所 (既定値 == 0、-1 == FileSize)。

Note

   このテスト バイナリのコマンドライン ヘルプを表示するには、「/?」と入力します。

 

ファイル一覧

ファイル インストール先

rapidfile.exe

<testbinroot>\NTTEST\Basetest\core_file_services\Shared_Tests\Wdk\

ntlog.dll

<osbinroot>\NTTest\CommonTest\NtLog\

ntlogger.ini

<osbinroot>\NTTest\CommonTest\NtLog\

dtresslog.dll

<testbinroot>\NTTest\basetest\core_file_services\shared_libs\

 

パラメーター

パラメーター名 パラメーターの説明
LLU_NetAccessOnly
FILE_SIZE