drivers/filesystems/fastfat_new/README.md

   1 <!---
   2     name: fastfat File System Driver
   3     platform: WDM
   4     language: cpp
   5     category: FileSystem
   6     description: A file system driver based on the Windows inbox FastFAT file system used as a model for new file systems.
   7     samplefwlink: http://go.microsoft.com/fwlink/p/?LinkId=620305
   8 --->
   9
  10
  11
  12 fastfat File System Driver
  13 ==========================
  14
  15 The *fastfat* sample is file system driver that you can use as a model to write new file systems.
  16
  17 *fastfat* is a complete file system that addresses various issues such as storing data on disk, interacting with the cache manager, and handling various I/O operations such as file creation, performing read/writes on a file, setting information on a file, and performing control operations on the file system.
  18
  19 ## Universal Windows Driver Compliant
  20 This sample builds a Universal Windows Driver. It uses only APIs and DDIs that are included in OneCoreUAP.
  21
  22 Build the sample
  23 ----------------
  24
  25 You can build the sample in two ways: using Microsoft Visual Studio or the command line (*MSBuild*).
  26
  27 ### Building a Driver Using Visual Studio
  28
  29 You build a driver the same way you build any project or solution in Visual Studio. When you create a new driver project using a Windows driver template, the template defines a default (active) project configuration and a default (active) solution build configuration. When you create a project from existing driver sources or convert existing driver code that was built with previous versions of the WDK, the conversion process preserves the target version information (operating systems and platform).
  30
  31 The default Solution build configuration is **Debug** and **Win32**.
  32
  33 **To select a configuration and build a driver**
  34
  35 1.  Open the driver project or solution in Visual Studio (find fastfat.sln or fastfat.vcxproj).
  36 2.  Right-click the solution in the **Solutions Explorer** and select **Configuration Manager**.
  37 3.  From the **Configuration Manager**, select the **Active Solution Configuration** (for example, Debug or Release) and the **Active Solution Platform** (for example, Win32) that correspond to the type of build you are interested in.
  38 4.  From the Build menu, click **Build Solution** (Ctrl+Shift+B).
  39
  40 ### Building a Driver Using the Command Line (MSBuild)
  41
  42 You can build a driver from the command line using the Visual Studio Command Prompt window and the Microsoft Build Engine (MSBuild.exe) Previous versions of the WDK used the Windows Build utility (Build.exe) and provided separate build environment windows for each of the supported build configurations. You can now use the Visual Studio Command Prompt window for all build configurations.
  43
  44 **To select a configuration and build a driver or an application**
  45
  46 1.  Open a Visual Studio Command Prompt window at the **Start** screen. From this window you can use MsBuild.exe to build any Visual Studio project by specifying the project (.VcxProj) or solutions (.Sln) file.
  47 2.  Navigate to the project directory and enter the **MSbuild** command for your target. For example, to perform a clean build of a Visual Studio driver project called *filtername*.vcxproj, navigate to the project directory and enter the following MSBuild command:
  48
  49     **msbuild /t:clean /t:build .\\fastfat.vcxproj**.
  50
  51 Installation
  52 ------------
  53
  54 No INF file is provided with this sample because the *fastfat* file system driver (fastfat.sys) is already part of the Windows operating system. You can build a private version of this file system and use it as a replacement for the native driver.