WDK开发环境构建驱动程序入门、Windows驱动程序的Check Build和Free Build

叁歲伎倆 2023-01-01 09:51 183阅读 0赞

先安装WDK 7；驱动开发包 7；

![watermark_type_ZmFuZ3poZW5naGVpdGk_shadow_10_text_aHR0cHM6Ly9ibG9nLmNzZG4ubmV0L2JjYm9ibzIxY24_size_16_color_FFFFFF_t_70][]

包含 build环境，调试工具，设备仿真和测试相关；

![watermark_type_ZmFuZ3poZW5naGVpdGk_shadow_10_text_aHR0cHM6Ly9ibG9nLmNzZG4ubmV0L2JjYm9ibzIxY24_size_16_color_FFFFFF_t_70 1][]

路径；

![watermark_type_ZmFuZ3poZW5naGVpdGk_shadow_10_text_aHR0cHM6Ly9ibG9nLmNzZG4ubmV0L2JjYm9ibzIxY24_size_16_color_FFFFFF_t_70 2][]

DSF一时不知道是什么；

![watermark_type_ZmFuZ3poZW5naGVpdGk_shadow_10_text_aHR0cHM6Ly9ibG9nLmNzZG4ubmV0L2JjYm9ibzIxY24_size_16_color_FFFFFF_t_70 3][]

安装过程；

![20210101221311490.png][]

完成；

![20210101221323537.png][]

开始菜单出来两个一级菜单，调试工具，驱动开发包；

![20210101221334910.png][]

看一下构建环境，包含Checked和Free两种；有何区别？

![20210101221346948.png][]

"Checked build" 有 traces和asserts,  "Free build" 没有；基本上这两者与我们传统的 "Debug" 和 "Release" 相对应；

chk表示Checked，fre表示Free。主要的区别在于，checked build有traces和asserts，而free build没有。  
   
　　checked和free是怎么出现的呢？因为传统的用词一般是debug和retail（或者release）。

当Windows NT还处在开发阶段的时候，开发组的人还在用“debug”和“retail”。Debug和Retail的不同在于编译时的选项：

Compiler Optimization：开、关

Debug Traces：开、关

Assertions：开、关

Sanity checks：开、关

传统来说，Debug是“Optimization：关，Traces：开，Assertions：开”，Retail是“O：开，T：关，A：关”。后来，NT团队加入了Sanity checks的选项。本来，Sanity check在内部版本中有，在发布的时候会移除掉。  
   
　　于是，NT的团队就有了“O：开，T：开，A：开，S：开”，“O：开，T：关，A：关，S：开”和“O：开，T：关，A：关，S：关”三种Build。

最后一种是传统的“retail” build。那么，前两种叫什么build呢？第一种Optimization是开着的，所以不是传统的“debug”，后一种Sanity check是开着的，所以不是传统的“retail”。  
   
　　为了区别这些build的不同。讨论以后，NT团队决定用“checked”表示“O：开，T：开，A：开，S：开”，“Free”表示“O：开，T：关，A：关，S：开”。Checked是因为所以的check都打开了，Free是因为“check free”。  
   
　　后来，随着NT 3.1项目进展，团队认识到：

他们其实根本就不会去测试“retail” build，

他们对free build进行了性能测试，结果发现它能够满足性能要求。

于是，团队把free build作为最终版本发布。

进到一个build环境命令提示符；输入 build 命令； 我的本意是看一下 build 命令的帮助；结果一行行提示自己出来，看上去不停地在运行某个程序；原来在安装的一级或二级目录下直接打build命令，会自动构建WDK本身自带的全部驱动程序例子；

![watermark_type_ZmFuZ3poZW5naGVpdGk_shadow_10_text_aHR0cHM6Ly9ibG9nLmNzZG4ubmV0L2JjYm9ibzIxY24_size_16_color_FFFFFF_t_70 4][]

先Ctrl-C终止；

做一个入门WDK驱动程序，代码如下；存为test.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;
    }

相关参考见此：[https://docs.microsoft.com/zh-cn/windows-hardware/drivers/gettingstarted/writing-a-very-small-kmdf--driver][https_docs.microsoft.com_zh-cn_windows-hardware_drivers_gettingstarted_writing-a-very-small-kmdf--driver]

有关WDK驱动程序构建的参考见

https://docs.microsoft.com/zh-cn/windows-hardware/drivers/devtest/tools-for-building-drivers  
    https://www.baidu.com/link?url=gofQddvm4cFhKAFxAD1iH0\_YNCjokCmRwhWT5SEKaaWhbkQPew\_4nTGZRiuBBX9bK8r98rY4F-FZuzSfC7o-SPME2VHxHqYizvD8EV7M7Ly&wd=&eqid=a98c2ec5000d4902000000065fef218a

从Checked Build 环境，切换到test.c所在目录，输入build test.c，看一下能否构建出一个test.sys的驱动程序；构建完成，Done；

![watermark_type_ZmFuZ3poZW5naGVpdGk_shadow_10_text_aHR0cHM6Ly9ibG9nLmNzZG4ubmV0L2JjYm9ibzIxY24_size_16_color_FFFFFF_t_70 5][]

没有出来.sys为后缀的驱动程序；还不是很清楚这概念，可能到某一版本后，MS的构建应用程序的build和构建驱动程序的build，可能是一个，只是通过不同的参数和环境，来构建出不同的程序类型；

![20210101221445476.png][]

看一下安装目录的下面目录，是一个wmi示例驱动程序；

![watermark_type_ZmFuZ3poZW5naGVpdGk_shadow_10_text_aHR0cHM6Ly9ibG9nLmNzZG4ubmV0L2JjYm9ibzIxY24_size_16_color_FFFFFF_t_70 6][]

adm64目录下都是源文件；构建一下此驱动示例，看能否生成.sys驱动；amd64架构的驱动程序，构建成功以后，出现在amd64目录下；如果是构建x86的驱动程序，则.sys出现在i386目录下；

![watermark_type_ZmFuZ3poZW5naGVpdGk_shadow_10_text_aHR0cHM6Ly9ibG9nLmNzZG4ubmV0L2JjYm9ibzIxY24_size_16_color_FFFFFF_t_70 7][]

构建wmisamp示例；完毕后显示 Done，wmisamp.sys，1 executable built；

![watermark_type_ZmFuZ3poZW5naGVpdGk_shadow_10_text_aHR0cHM6Ly9ibG9nLmNzZG4ubmV0L2JjYm9ibzIxY24_size_16_color_FFFFFF_t_70 8][]

看一下amd64目录下，出来一个.sys驱动程序；

![watermark_type_ZmFuZ3poZW5naGVpdGk_shadow_10_text_aHR0cHM6Ly9ibG9nLmNzZG4ubmV0L2JjYm9ibzIxY24_size_16_color_FFFFFF_t_70 9][]

[watermark_type_ZmFuZ3poZW5naGVpdGk_shadow_10_text_aHR0cHM6Ly9ibG9nLmNzZG4ubmV0L2JjYm9ibzIxY24_size_16_color_FFFFFF_t_70]: /images/20221120/5b875c40cefd41729e5c98a993a3b061.png
[watermark_type_ZmFuZ3poZW5naGVpdGk_shadow_10_text_aHR0cHM6Ly9ibG9nLmNzZG4ubmV0L2JjYm9ibzIxY24_size_16_color_FFFFFF_t_70 1]: /images/20221120/0f08a95688454327897ea402f22259ca.png
[watermark_type_ZmFuZ3poZW5naGVpdGk_shadow_10_text_aHR0cHM6Ly9ibG9nLmNzZG4ubmV0L2JjYm9ibzIxY24_size_16_color_FFFFFF_t_70 2]: /images/20221120/f2793ffc2b884c759447f45ff917c65b.png
[watermark_type_ZmFuZ3poZW5naGVpdGk_shadow_10_text_aHR0cHM6Ly9ibG9nLmNzZG4ubmV0L2JjYm9ibzIxY24_size_16_color_FFFFFF_t_70 3]: https://img-blog.csdnimg.cn/20210101221259316.png?x-oss-process=image/watermark,type_ZmFuZ3poZW5naGVpdGk,shadow_10,text_aHR0cHM6Ly9ibG9nLmNzZG4ubmV0L2JjYm9ibzIxY24=,size_16,color_FFFFFF,t_70
[20210101221311490.png]: https://img-blog.csdnimg.cn/20210101221311490.png
[20210101221323537.png]: https://img-blog.csdnimg.cn/20210101221323537.png
[20210101221334910.png]: https://img-blog.csdnimg.cn/20210101221334910.png
[20210101221346948.png]: https://img-blog.csdnimg.cn/20210101221346948.png
[watermark_type_ZmFuZ3poZW5naGVpdGk_shadow_10_text_aHR0cHM6Ly9ibG9nLmNzZG4ubmV0L2JjYm9ibzIxY24_size_16_color_FFFFFF_t_70 4]: https://img-blog.csdnimg.cn/20210101221408200.png?x-oss-process=image/watermark,type_ZmFuZ3poZW5naGVpdGk,shadow_10,text_aHR0cHM6Ly9ibG9nLmNzZG4ubmV0L2JjYm9ibzIxY24=,size_16,color_FFFFFF,t_70
[https_docs.microsoft.com_zh-cn_windows-hardware_drivers_gettingstarted_writing-a-very-small-kmdf--driver]: https://docs.microsoft.com/zh-cn/windows-hardware/drivers/gettingstarted/writing-a-very-small-kmdf--driver
[watermark_type_ZmFuZ3poZW5naGVpdGk_shadow_10_text_aHR0cHM6Ly9ibG9nLmNzZG4ubmV0L2JjYm9ibzIxY24_size_16_color_FFFFFF_t_70 5]: https://img-blog.csdnimg.cn/20210101221419816.png?x-oss-process=image/watermark,type_ZmFuZ3poZW5naGVpdGk,shadow_10,text_aHR0cHM6Ly9ibG9nLmNzZG4ubmV0L2JjYm9ibzIxY24=,size_16,color_FFFFFF,t_70
[20210101221445476.png]: https://img-blog.csdnimg.cn/20210101221445476.png
[watermark_type_ZmFuZ3poZW5naGVpdGk_shadow_10_text_aHR0cHM6Ly9ibG9nLmNzZG4ubmV0L2JjYm9ibzIxY24_size_16_color_FFFFFF_t_70 6]: https://img-blog.csdnimg.cn/20210101221458748.png?x-oss-process=image/watermark,type_ZmFuZ3poZW5naGVpdGk,shadow_10,text_aHR0cHM6Ly9ibG9nLmNzZG4ubmV0L2JjYm9ibzIxY24=,size_16,color_FFFFFF,t_70
[watermark_type_ZmFuZ3poZW5naGVpdGk_shadow_10_text_aHR0cHM6Ly9ibG9nLmNzZG4ubmV0L2JjYm9ibzIxY24_size_16_color_FFFFFF_t_70 7]: https://img-blog.csdnimg.cn/20210101221509335.png?x-oss-process=image/watermark,type_ZmFuZ3poZW5naGVpdGk,shadow_10,text_aHR0cHM6Ly9ibG9nLmNzZG4ubmV0L2JjYm9ibzIxY24=,size_16,color_FFFFFF,t_70
[watermark_type_ZmFuZ3poZW5naGVpdGk_shadow_10_text_aHR0cHM6Ly9ibG9nLmNzZG4ubmV0L2JjYm9ibzIxY24_size_16_color_FFFFFF_t_70 8]: https://img-blog.csdnimg.cn/20210101221520797.png?x-oss-process=image/watermark,type_ZmFuZ3poZW5naGVpdGk,shadow_10,text_aHR0cHM6Ly9ibG9nLmNzZG4ubmV0L2JjYm9ibzIxY24=,size_16,color_FFFFFF,t_70
[watermark_type_ZmFuZ3poZW5naGVpdGk_shadow_10_text_aHR0cHM6Ly9ibG9nLmNzZG4ubmV0L2JjYm9ibzIxY24_size_16_color_FFFFFF_t_70 9]: https://img-blog.csdnimg.cn/20210101221531487.png?x-oss-process=image/watermark,type_ZmFuZ3poZW5naGVpdGk,shadow_10,text_aHR0cHM6Ly9ibG9nLmNzZG4ubmV0L2JjYm9ibzIxY24=,size_16,color_FFFFFF,t_70