我的第一个Winxp sp2驱动程序(hello world)

最新推荐文章于 2021-05-25 00:13:28 发布

SworderAndy

最新推荐文章于 2021-05-25 00:13:28 发布

阅读量1.2k

点赞数

分类专栏：驱动程序框架和操作系统文章标签： extension object ddk windows class file

本文链接：https://blog.csdn.net/SworderAndy/article/details/2066799

版权

驱动程序框架和操作系统专栏收录该内容

2 篇文章

订阅专栏

经过半个多月的煎熬终于推出了我的第一个驱动程序,虽然不能真正的驱动什么设备,但是我还是很激动,贴出来恭大家批评指正.

我的驱动程序是从网上一位前辈的写的,功能再简单不过了,就是在设备管理器中看到它的身影,其他的没有任何作用,但是程序是在2002年写的,那时还没有WINXP sp2,所以环境有些不一样,在加上我一开始什么都不懂,走了不少弯路.不过现在还是有很多不明白的.

开发驱动程序少不了要安装DDK,我一开始安装的是winxpsp1的,后来换成了IFSKIT(也是别人建议我安装的,不太清楚跟DDK有什么关系,好象里多了Win2003的DDK),例子程序如下:

//HelloWDM.h

#ifdef __cplusplus

extern "C"
{
#endif
#include <wdm.h>

//本来是包含的ntddk.h,但是它编译通不过，可能是比较的老是头文件吧。后来换成了wdm.h才通过

//#include "ntddk.h"
#ifdef __cplusplus
}
#endif

typedef struct _DEVICE_EXTENSION
{
PDEVICE_OBJECT fdo;
PDEVICE_OBJECT NextStackDevice;
UNICODE_STRING ifSymLinkName;

} DEVICE_EXTENSION, *PDEVICE_EXTENSION;

NTSTATUS HelloWDMAddDevice(IN PDRIVER_OBJECT DriverObject,
IN PDEVICE_OBJECT PhysicalDeviceObject);

NTSTATUS HelloWDMPnp(IN PDEVICE_OBJECT fdo,
IN PIRP Irp);

_____________________________________________________________________________

//HelloWDM.cpp

#include "HelloWDM.h"

extern "C"
NTSTATUS DriverEntry( IN PDRIVER_OBJECT DriverObject,
IN PUNICODE_STRING RegistryPath)
{
//指定“添加设备”消息由函数“HelloWDMAddDevice()”来处理：
DriverObject->DriverExtension->AddDevice = HelloWDMAddDevice;
//指定“即插即用”消息由函数“HelloWDMPnp()”来处理：
DriverObject->MajorFunction[IRP_MJ_PNP] = HelloWDMPnp;

//返回一个NTSTATUS值STATUS_SUCCESS。几乎所有的驱动程序例程都必须返回一个NTSTATUS值，这些值在NTSTATUS.H DDK头文件中有详细的定义。
return STATUS_SUCCESS;
}

NTSTATUS HelloWDMAddDevice(IN PDRIVER_OBJECT DriverObject,
IN PDEVICE_OBJECT PhysicalDeviceObject)
{
//定义一个NTSTATUS类型的返回值：
NTSTATUS status;
//定义一个功能设备对象（Functional Device Object）：
PDEVICE_OBJECT fdo;

//创建我们的功能设备对象，并储存到fdo中：
status = IoCreateDevice(
DriverObject, //驱动程序对象
sizeof(DEVICE_EXTENSION), //要求的设备扩展的大小
NULL, //设备名称，这里为NULL
FILE_DEVICE_UNKNOWN, //设备的类型，在标准头文件WDM.H或NTDDK.H中列出的FILE_DEVICE_xxx值之一
0, //各种常量用OR组合在一起，指示可删除介质、只读等。
FALSE, //如果一次只有一个线程可以访问该设备，为TRUE，否则为FALSE
&fdo); //返回的设备对象

//NT_SUCCESS宏用于测试IoCreateDevice内核是否成功完成。不要忘记检查对内核的所有调用是否成功。NT_ERROR宏不等同于!NT_SUCCESS，最好使用!NT_SUCCESS，因为除了错误外，它还截获警告信息。
if( !NT_SUCCESS(status))
return status;

//创建一个设备扩展对象dx，用于存储指向fdo的指针：
PDEVICE_EXTENSION dx = (PDEVICE_EXTENSION)fdo->DeviceExtension;
dx->fdo = fdo;

//用IoAttachDeviceToDeviceStack函数把HelloWDM设备挂接到设备栈：
dx->NextStackDevice = IoAttachDeviceToDeviceStack(fdo, PhysicalDeviceObject);

//设置fdo的flags。有两个“位”是必须改变的，一个是必须清除DO_DEVICE_INITIALIZING标志，如果在DriverEntry例程中调用IoCreateDevice()，就不需要清除这个标志位。还有一个是必须设置DO_BUFFER_IO标志位：
fdo->Flags |= DO_BUFFERED_IO | DO_POWER_PAGABLE;
fdo->Flags &= ~DO_DEVICE_INITIALIZING;

//返回值：
return STATUS_SUCCESS;
}

NTSTATUS HelloWDMPnp(IN PDEVICE_OBJECT fdo,
IN PIRP Irp)
{
//创建一个设备扩展对象dx，用于存储指向fdo的指针：
PDEVICE_EXTENSION dx=(PDEVICE_EXTENSION)fdo->DeviceExtension;

//首先要通过函数IoGetCurrentIrpStackLocation()得到当前的IRP，并由此得到Minor Function：
PIO_STACK_LOCATION IrpStack = IoGetCurrentIrpStackLocation(Irp);
ULONG MinorFunction = IrpStack->MinorFunction;

//然后把这个Minor Function传递给下一个设备栈：
IoSkipCurrentIrpStackLocation(Irp);
NTSTATUS status = IoCallDriver( dx->NextStackDevice, Irp);

//处理“即插即用”次功能代码：
//当Minor Function等于IRP_MN_REMOVE_DEVICE时，说明有设备被拔出或卸下，这时要取消资源分配并删除设备：
if( MinorFunction==IRP_MN_REMOVE_DEVICE)
{
    //取消设备接口：
    IoSetDeviceInterfaceState(&dx->ifSymLinkName, FALSE);
    RtlFreeUnicodeString(&dx->ifSymLinkName);

    //调用IoDetachDevice()把fdo从设备栈中脱开：
    if (dx->NextStackDevice)
      IoDetachDevice(dx->NextStackDevice);
    //删除fdo：
    IoDeleteDevice(fdo);
}

//返回值：
return status;
}

_____________________________________________________________________________

#makefile文件(没有扩展名)

#
# DO NOT EDIT THIS FILE!!! Edit ./sources. If you want to add a new source
# file to this component. This file merely indirects to the real make file
# that is shared by all the driver components of the Windows NT DDK
#

!INCLUDE $(NTMAKEENV)/makefile.def

_____________________________________________________________________________

#source文件(没有扩展名)

TARGETNAME=HelloWDM
TARGETTYPE=DRIVER
DRIVERTYPE=WDM
TARGETPATH=OBJ

SOURCES=HelloWDM.cpp/

_____________________________________________________________________________

然后在开始菜单中点击Windows XP Checked Build Environment,在弹出的DOS窗口中切换到程序所在的目录(包含上面的四个文件的文件夹),输入build,如果没有错误的话会在当前目录下生成objchk_wxp_x86目录,下面有个i386目录,其中就包含了驱动程序文件HelloWDM.sys了.

然后就是安装了,其实安装比编译更加的麻烦,主要原因就是安装用的inf文件要自己编写,这里还算顺利.我在NT环境下开发的驱动,所以就要在Mfg0中选择YouMark_DDI.NT,在后面的ID里随便写了个编号(hehe),然后建立目录objfre/i386,将HelloWDM拷过来.下面的就是我的INF

;--------- Version Section ---------------------------------------------------

[Version]
Signature="$CHICAGO$"
Provider=LC_Device
DriverVer=8/21/2002,3.0.0.3

; If device fits one of the standard classes, use the name and GUID here,
; otherwise create your own device class and GUID as this example shows.

Class=MyMissiles
ClassGUID={40EDD7EF-EAD8-4693-9256-5F70D920B2F3}

;--------- SourceDiskNames and SourceDiskFiles Section -----------------------

; These sections identify source disks and files for installation. They are
; shown here as an example, but commented out.

[SourceDisksNames]
1 = "HelloWDM",Disk1,,

[SourceDisksFiles]
HelloWDM.sys = 1,objfre/i386,

;--------- ClassInstall/ClassInstall32 Section -------------------------------

; Not necessary if using a standard class

; 9X Style
[ClassInstall]
Addreg=Class_AddReg

; NT Style
[ClassInstall32]
Addreg=Class_AddReg

[Class_AddReg]
HKR,,,,%DeviceClassName%
HKR,,Icon,,"-5"

;--------- DestinationDirs Section -------------------------------------------

[DestinationDirs]
YouMark_Files_Driver = 10,System32/Drivers

;--------- Manufacturer and Models Sections ----------------------------------

[Manufacturer]
%MfgName%=Mfg0

[Mfg0]

; PCI hardware Ids use the form
; PCI/VEN_aaaa&DEV_bbbb&SUBSYS_cccccccc&REV_dd
;改成你自己的ID
%DeviceDesc%=YouMark_DDI.NT, PCI/VEN_1234&DEV_5678

;---------- DDInstall Sections -----------------------------------------------
; --------- Windows 9X -----------------

; Experimentation has shown that DDInstall root names greater than 19 characters
; cause problems in Windows 98

[YouMark_DDI]
CopyFiles=YouMark_Files_Driver
AddReg=YouMark_9X_AddReg

[YouMark_9X_AddReg]
HKR,,DevLoader,,*ntkern
HKR,,NTMPDriver,,HelloWDM.sys
HKR, "Parameters", "BreakOnEntry", 0x00010001, 0

; --------- Windows NT -----------------

[YouMark_DDI.NT]
CopyFiles=YouMark_Files_Driver
AddReg=YouMark_NT_AddReg

[YouMark_DDI.NT.Services]
Addservice = HelloWDM, 0x00000002, YouMark_AddService

[YouMark_AddService]
DisplayName = %SvcDesc%
ServiceType = 1 ; SERVICE_KERNEL_DRIVER
StartType = 3 ; SERVICE_DEMAND_START
ErrorControl = 1 ; SERVICE_ERROR_NORMAL
ServiceBinary = %10%/System32/Drivers/HelloWDM.sys

[YouMark_NT_AddReg]
HKLM, "System/CurrentControlSet/Services/HelloWDM/Parameters",/
"BreakOnEntry", 0x00010001, 0

; --------- Files (common) -------------

[YouMark_Files_Driver]
HelloWDM.sys

;--------- Strings Section ---------------------------------------------------

[Strings]
ProviderName="Flying L Co.,Ltd."
MfgName="LC Soft"
DeviceDesc="Hello World WDM!"
DeviceClassName="LC_Device"
SvcDesc="???"

最后一步了,就是打开Windows的控制面板,选择添加新硬件,在弹出的对话框点下一步,选是,我已连接此硬件,点下一步,选择最下面的添加新的硬件设备,点下一步选安装我手动从列表选择的硬件,点下一步,选显示所有设备,点下一步,点从磁盘安装,在弹出的对话框中选择HelloWDM所在的目录,该目录应该有objfre/i386/文件夹和里面的HelloWDM.sys文件,好了,最激动的时刻到来了,当安装提示成功的时候,打开你的设备管理器看看吧.里面会多了一个叫LC_Device的设备类,点击旁边的加号,就会显示一个Hello World WDM!设备.

哈哈,是不是很cool,其实驱动开发是一个漫长的过程,所涉及的东西太多,但不管怎样我总算迈出了第一步.