如何在win10+VS2017环境下新建一个简单的WDF示例程序

上一课我们在win10系统+VS2017开发环境下搭建了WDK驱动程序开发环境的搭建，详见我的博客【如何在win10+VS2017环境下安装USB驱动开发套件WDK】，今天我们来尝试建立一个最简单的KDM示例工程。

提前说明：本博客所建立的示例工程的源码，我上传在了CSDN里【https://download.csdn.net/download/leon1741/10957680】，大家可以自行去下载。不过遗憾的是，现在CSDN资源的下载积分规则改了，不能由上传者来设置该资源的下载积分，而是由系统自动适配的。因此，这个资源的下载积分目前需要5分，有点多，我其实想设置成免费或者最多1分的，可是系统不让我改。希望各位的积分值够用，或者希望系统过段时间自动把下载积分值降下来吧…

第一步：新建工程

记得要选择WDF模型下的空KMD驱动项目，项目名我输的是KMD_Test，大家可以自己更改。

第二步、输入代码

在源代码文件夹上右击，选择新建一个空白文件。

输入文件名为Drive.c。请注意，不是Drive.cpp，而是Drive.c！

在文件中输入以下内容：

#include <ntddk.h>
#include <wdf.h>

DRIVER_INITIALIZE DriverEntry;
EVT_WDF_DRIVER_DEVICE_ADD KmdfHelloWorldEvtDeviceAdd;

NTSTATUS
DriverEntry(
    _In_ PDRIVER_OBJECT     DriverObject,
    _In_ PUNICODE_STRING    RegistryPath
)
{
    // NTSTATUS variable to record success or failure
    NTSTATUS status = STATUS_SUCCESS;

    // Allocate the driver configuration object
    WDF_DRIVER_CONFIG config;

    // Print "Hello World" for DriverEntry
    KdPrintEx((DPFLTR_IHVDRIVER_ID, DPFLTR_INFO_LEVEL, "KmdfHelloWorld: DriverEntry\n"));

    // Initialize the driver configuration object to register the
    // entry point for the EvtDeviceAdd callback, KmdfHelloWorldEvtDeviceAdd
    WDF_DRIVER_CONFIG_INIT(&config,
        KmdfHelloWorldEvtDeviceAdd
    );

    // Finally, create the driver object
    status = WdfDriverCreate(DriverObject,
        RegistryPath,
        WDF_NO_OBJECT_ATTRIBUTES,
        &config,
        WDF_NO_HANDLE
    );
    return status;
}

NTSTATUS
KmdfHelloWorldEvtDeviceAdd(
    _In_    WDFDRIVER       Driver,
    _Inout_ PWDFDEVICE_INIT DeviceInit
)
{
    // We're not using the driver object,
    // so we need to mark it as unreferenced
    UNREFERENCED_PARAMETER(Driver);

    NTSTATUS status;

    // Allocate the device object
    WDFDEVICE hDevice;

    // Print "Hello World"
    KdPrintEx((DPFLTR_IHVDRIVER_ID, DPFLTR_INFO_LEVEL, "KmdfHelloWorld: KmdfHelloWorldEvtDeviceAdd\n"));

    // Create the device object
    status = WdfDeviceCreate(&DeviceInit,
        WDF_NO_OBJECT_ATTRIBUTES,
        &hDevice
    );
    return status;
}

第三步：项目配置

首先切换到x64平台下，选择debug模式。

然后打开项目属性的窗口，完成以下设置：

第四步、全文编译

无需其他操作，点击编译按钮即可！

1>------ Build started: Project: KMD_Test, Configuration: Debug x64 ------
1>Building 'KMD_Test' with toolset 'WindowsKernelModeDriver10.0' and the 'Universal' target platform.
1>C:\Program Files (x86)\Microsoft Visual Studio\2017\Community\Common7\IDE\VC\VCTargets\Microsoft.CppBuild.targets(402,5): warning MSB8038: Spectre mitigation is enabled but Spectre mitigated libraries are not found.  Verify that the Visual Studio Workload includes the Spectre mitigated libraries.  See https://aka.ms/Ofhn4c for more information.
1>Stamping x64\Debug\KMD_Test.inf
1>Stamping [Version] section with DriverVer=02/14/2019,18.56.35.708
1>Drive.c
1>KMD_Test.vcxproj -> D:\A_Download\KMD_Test\x64\Debug\KMD_Test.sys
1>Done Adding Additional Store
1>Successfully signed: D:\A_Download\KMD_Test\x64\Debug\KMD_Test.sys
1>
1>Driver is a Universal Driver.
1>........................
1>Signability test complete.
1>
1>Errors:
1>None
1>
1>Warnings:
1>None
1>
1>Catalog generation complete.
1>D:\A_Download\KMD_Test\x64\Debug\KMD_Test\kmd_test.cat
1>[0x7FF9F8B95140] ANOMALY: meaningless REX prefix used
1>[0x7FF9F8B95180] ANOMALY: meaningless REX prefix used
1>[0x7FF9F8B95380] ANOMALY: meaningless REX prefix used
1>[0x7FF9F8B935F0] ANOMALY: meaningless REX prefix used
1>[0x7FF9F8B91FD0] ANOMALY: meaningless REX prefix used
1>Done Adding Additional Store
1>Successfully signed: D:\A_Download\KMD_Test\x64\Debug\KMD_Test\kmd_test.cat
1>
1>Done building project "KMD_Test.vcxproj".
========== Build: 1 succeeded, 0 failed, 0 up-to-date, 0 skipped ==========

编译出来的驱动程序，均放在”项目目录\Debug\KMD_Test“目录下：

• KMD_Test.sys – 最关键的内核模式驱动文件；
• KMD_Test.inf – 安装驱动时提供给系统使用的信息文件；
• KMD_Test.cat – 安装程序用来鉴别驱动签名状态的目录文件；

注：以上全部过程，均是参考微软官方的指导文档执行下来，大家若有兴趣可以自行参阅【Write a KMDF Hello World driver】。

另外，也可以参考微软在github上提供的一份全套示例参考【https://github.com/Microsoft/Windows-driver-samples】。

OK，新建的工程已经顺利编译成功，驱动程序也已经生成完毕，本篇到此为止。下一篇我们将继续研究如何进行驱动程序的调试和安装。

---

篇后语：

这里补充一下，安装完WDK之后，如果去编译其他的C++工程，有可能会遇到【LINK : fatal error LNK1104: 无法打开文件“MSVCRTD.lib”】之类的问题，请不要慌张，不要去网上乱找，这个问题的原因其实很简单，参考我的另一篇博客【如何解决win10+VS2017+WDK环境下编译C++程序提示error LNK1104无法打开文件*.lib的问题】即可！