Write a UMDF driver based on a template

To write a User-Mode Driver Framework (UMDF) driver, you can use a Microsoft Visual Studio template. To get started, be sure you have Visual Studio and the Windows Driver Kit (WDK) installed. You can download them from the Windows Hardware Dev Center.

Debugging Tools for Windows is included when you install the WDK.

Create and build a driver package

  1. Open Visual Studio. On the File menu, choose New > Project.
  2. In the New Project dialog box, in the left pane, go to Online > Templates.
  3. In the New Project dialog box, in the upper-right corner, search for the template by name: User Mode Driver, WRL (UMDF).
  4. In the Name field, enter "UmdfDriver" as the project name.

    Note  When you create a new KMDF or UMDF driver, you must select a driver name that has 32 characters or less. This length limit is defined in wdfglobals.h.

  5. In the Location field, enter the directory where you want to create the new project.
  6. Check Create directory for solution. Click OK.

    Screen shot of the New Project dialog box, showing WDF and User Mode Driver selected

    Visual Studio creates two projects and a solution. You can see them in the Solution Explorer window. (If the Solution Explorer window is not visible, choose Solution Explorer from the View menu.) The solution has a driver project named UmdfDriver and a driver package project named UmdfDriver Package. To see the driver source code, open any of the files under Source Files. Driver.cpp and Device.cpp are good places to start.

    Screen shot of Solution Explorer showing the files in the driver project and the package project
  7. In the Solution Explorer window, right-click Solution 'UmdfDriver' (2 projects), and choose Configuration Manager. Choose a configuration and platform for both the driver project and the package project. For example, choose Win 8.1 Debug and x64.

  8. To build your driver and create a driver package, choose Build Solution from the Build menu. Microsoft Visual Studio displays build progress in the Output window. (If the Output window is not visible, choose Output from the View menu.)

    When you've verified that the solution built successfully, you can close Visual Studio.

  9. To see the built driver package, in File Explorer, go to your UmdfDriver folder, and then to x64\Win8.1Debug\UmdfDriver PackageThe driver package has several files:

    • UmdfDriver.dll -- the user-mode driver file
    • UmdfDriver.inf -- an information file that Windows uses when you install the driver
    • UmdfDriver.cat -- a catalog file that contains a test signature for the package

    There might also be a coinstaller file in the package.

Deploy and installing the driver

Typically when you test and debug a driver, the debugger and driver run on separate computers. The computer that runs the debugger is called the host computer, and the computer that runs the driver is called the target computer. The target computer is also called the test computer.

So far, you've used Visual Studio to build a driver on the host computer. Now you need to configure a target computer. Follow the instructions in Provision a computer for driver deployment and testing (WDK 8.1). Then you'll be ready to deploy, install, load, and debug your driver:

  1. On the host computer, open your solution in Visual Studio. You can double-click the solution file, UmdfDriver.sln, in your UmdfDriver folder.
  2. In the Solution Explorer window, right-click UmdfDriver Package, and choose Properties.
  3. In the UmdfDriver Package Property Pages window, go to Configuration Properties > Driver Install > Deployment, as shown here.
  4. Check Enable deployment, and check Remove previous driver versions before deployment.
  5. For Remote Computer Name, select the name of the computer that you configured for testing and debugging. In this exercise, we use a computer named MyTestComputer.
  6. Select Hardware ID Driver Update, and enter the hardware ID for your driver. In this exercise, the hardware ID is Root\UmdfDriver. Click OK.

    Screen shot of the UmdfDriver Package Property Pages, showing Deployment Driver Install selected

    Note  In this exercise, the hardware ID does not identify a real piece of hardware. It identifies an imaginary device that will be given a place in the device tree as a child of the root node. For real hardware, do not select Hardware ID Driver Update; instead, select Install and Verify.

    You can see the hardware ID in your driver's information (INF) file. In the Solution Explorer window, go to UmdfDriver > Driver Files, and double-click UmdfDriver.inf. The hardware ID is under [Standard.NT$ARCH$].

    
    [Standard.NT$ARCH$]
    %DeviceName%=MyDevice_Install,Root\UmdfDriver
    
    
  7. On the Debug menu, choose Start Debugging, or press F5 on the keyboard.
  8. Wait until your driver has been deployed, installed, and loaded on the target computer. This might take several minutes.

Related topics

Developing, Testing, and Deploying Drivers
Debugging Tools for Windows
Write your first driver

 

 

Send comments about this topic to Microsoft

Show:
© 2014 Microsoft