File IO 2 Tests

  • Article

This automated test verifies basic file I/O on the driver stack.

You can use the test to verify the following information:

  • The context in which the test or variation ran (for example, x86, file system, local/remote, language, build number)

  • Pass, fail, and variation count numbers

  • If failed, information that can help determine the cause of failure

The File IO 2 tests are based on TAEF:

  • To list the tests, run the following:

    te FileIOTestA.dll /list

  • To run all tests with priority zero (the highest priority, which is the default priority in RunFileIo2.cmd) on a particular test volume, run the following:

    TE.exe FileIOTestA.dll /select:@Priority=0  /p:Volume=%DRIVE_LETTER%

For more information about the behavior of file systems, see File System Behavior in the Microsoft Windows Environment.

Test details

   
Specifications
  • Filter.Driver.FileSystem.MiniFilter
  • Filter.Driver.AntiVirus.MiniFilter
  • Filter.Driver.FileSystem.Functionality
Platforms
  • Windows 10, client editions (x86)
  • Windows 10, client editions (x64)
  • Windows Server 2016 (x64)
  • Windows 10, mobile edition (Arm)
Supported Releases
  • Windows 10
  • Windows 10, version 1511
  • Windows 10, version 1607
  • Windows 10, version 1703
  • Windows 10, version 1709
  • Windows 10, version 1803
  • Windows 10, version 1809
  • Windows 10, version 1903
  • Next update to Windows 10
Expected run time (in minutes) 300
Category Development
Timeout (in minutes) 18000
Requires reboot false
Requires special configuration false
Type automatic

 

Additional documentation

Tests in this feature area might have additional documentation, including prerequisites, setup, and troubleshooting information, that can be found in the following topic(s):

Running the test

For more information about requirements, see File System Testing Prerequisites.

In addition, this test requires extra hard drive space for four simple 2,048-megabyte (MB) partitions and two simple 1,024-MB partitions.

Before you run the test, you must add the following partitions to the test computer.

Label File system Size Expected drive letter

NTFS

NTFS

2,048 MB

g:

CNTFS

NTFS (compressed)

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:

 

RunFileIO.cmd contains references to environment variables that you can change to allow for skipping of certain file systems.

Troubleshooting

For generic troubleshooting of HLK test failures, see Troubleshooting Windows HLK Test Failures.

For general troubleshooting information, see Troubleshooting File System Testing.

This test returns Pass or Fail. To review test details, review the test log from Windows Hardware Lab Kit (Windows HLK) Studio.

The test uses Ntlog for logging the test results. Any failure is logged with the Win32® GetLastError() code.

More information

Command syntax

Command option Description

te FileIOTestA.dll /select:@Priority=0 /p:Volume=%DRIVE_LETTER%

 

File list

File Location
AttachFilter.cmd [WTT\TestBinRoot]\NTTest\BASETEST\Core_File_Services\FilterManager\TestSuite\Scripts\FileSystems\
IsREFSSupported.vbs [WTT\TestBinRoot]\NTTest\BASETEST\Core_File_Services\FilterManager\TestSuite\Scripts\FileSystems\
FioChild.exe [WTT\TestBinRoot]\base\fs\test\Shared_Tests\FileIO2\
FioDetours.dll [WTT\TestBinRoot]\base\fs\test\Shared_Tests\FileIO2\
FileIOTestA.dll [WTT\TestBinRoot]\base\fs\test\Shared_Tests\FileIO2\
FileIOTestW.dll [WTT\TestBinRoot]\base\fs\test\Shared_Tests\FileIO2\
ReadAsync.exe [WTT\TestBinRoot]\base\fs\test\Shared_Tests\FileIO2\
WriteAsync.exe [WTT\TestBinRoot]\base\fs\test\Shared_Tests\FileIO2\
RunFileIo2.cmd [WTT\TestBinRoot]\base\fs\test\Core_File_Services\FilterManager\TestSuite\Scripts\FileSystems\
WrapFileIO2.cmd [WTT\TestBinRoot]\base\fs\test\Core_File_Services\FilterManager\TestSuite\Scripts\FileSystems\

 

Parameters

Parameter name Parameter description
NTFS_DRIVE_LETTER The drive letter for the NTFS volume that the File IO 2 test will run on.
CNTFS_DRIVE_LETTER The drive letter for the Compressed NTFS volume that the File IO 2 test will run on.
FAT_DRIVE_LETTER The drive letter for the FAT volume that the File IO 2 test will run on.
FAT32_DRIVE_LETTER The drive letter for the FAT32 volume that the FileIO 2 test will run on.
EXFAT_DRIVE_LETTER The drive letter for the ExFat volume that the File IO 2 test will run on.
UDF_DRIVE_LETTER The drive letter for the UDF volume that the File IO 2 test will run on.
RUN_MODE Leave this on BVT.
LLU_LclAdminUser LLU for execute
LLU_NetAccessOnly LLU for copy
REFS_DRIVE_LETTER The drive letter for the ReFS volume that the test will run on. Enter NONE if not >= Win8 Server.