MSDN原文:https://msdn.microsoft.com/zh-cn/library/windows/hardware/ff554887(v=vs.85).aspx
创建驱动程序项目时,指定基本的目标操作系统,该系统是运行驱动程序的基本版本的 Windows。例如,你可以指定 Windows 7 为基本的目标操作系统。在这种情况下,驱动程序会在 Windows 7 和更高版本的 Windows 上运行。
注意 如果为特定的基本版本的 Windows 开发驱动程序且希望驱动程序运行在更高版本的 Windows 上,则不得使用任何未记录的函数,也不得采用文档中介绍方法之外的任何方法使用记录的函数。否则,驱动程序可能会无法运行在更高版本的 Windows 上。即便你已经很小心,仅使用记录的函数,也应在每次发布新版本的 Windows 时在其上对驱动程序进行测试。
编写仅使用共同功能的多版本驱动程序
设计将在多个版本的 Windows 上运行的驱动程序时,最简单的方法是允许驱动程序仅使用运行该驱动程序的所有版本的 Windows 共同的 DDI 函数和结构。在此情形下,将最基本的目标操作系统设置为驱动程序支持的最早版本的 Windows。
例如,要支持从 Windows 7 开始的所有版本的 Windows,应执行以下操作:
设计和实现驱动程序,以便该驱动程序仅使用 Windows 7 中提供的那些功能。
生成驱动程序时,将 Windows 7 指定为最基本的目标操作系统。
虽然此过程很简单,但它可能会限制驱动程序仅使用更高版本的 Windows 上提供的功能子集。
编写使用版本相关功能的多版本驱动程序内核模式驱动程序可以动态确定它运行的是哪个版本的 Windows 并且选择使用该版本上提供的功能。例如,必须支持从 Windows 7 开始的 Windows 所有版本的驱动程序可以在运行时确定它所运行的 Windows 版本。 如果驱动程序在 Windows 7 上运行,则它只能使用 Windows 7 支持的 DDI 函数。但是,同一个驱动程序可以使用仅适用于 Windows 8 的其他 DDI 函数,例如,当其运行时检查功能确定它在 Windows 8 上运行时。
确定 Windows 版本RtlIsNtDdiVersionAvailable 为驱动程序可以在运行时用于确定特定版本的 Windows 提供的功能是否可用的函数。该函数的原型如下所示:
BOOLEAN RtlIsNtDdiVersionAvailable(IN ULONG Version)
在此原型中,Version 是一个值,指示 Windows DDI 的所需版本。此值必须为 DDI 版本常量之一,在 sdkddkver.h 中定义,例如 NTDDI_WIN8 或 NTDDI_WIN7。
当调用程序运行在 Version. 指定的相同的 Windows 版本或更高版本上时,RtlIsNtDdiVersionAvailable 会返回 TRUE。
驱动程序还可以通过调用 RtlIsServicePackVersionInstalled 函数检查特定的 Service Pack。该函数的原型如下所示:
BOOLEAN RtlIsServicePackVersionInstalled(IN ULONG Version)
在此原型中,Version 为一个值,指示所需的 Windows 版本和 Service Pack。此值必须为 DDI 版本常量之一,在 sdkddkver.h 中定义,例如 NTDDI_WS08SP3。
注意,仅当操作系统版本与指定版本完全匹配时,RtlIsServicePackVersionInstalled 才会返回 TRUE。因此,如果驱动程序不是在 Windows Server 2008 SP4 上运行,则调用将 Version 设置为 NTDDI_WS08SP3 的 RtlIsServicePackVersionInstalled 会失败。
条件性调用与 Windows 版本相关的函数在驱动程序确定计算机上可用的特定操作系统版本后,该驱动程序可以使用 MmGetSystemRoutineAddress 函数动态查找例程并通过指针调用该例程。Windows 7 和更高版本的操作系统版本上提供了此函数。
注意 若要帮助保留键入检查和防止出现无意识的错误,应创建映射原始函数类型的 typedef。
示例:确定 Windows 版本并条件性调用版本相关的函数
此代码示例(来自驱动程序的头文件)将 PAISQSL 类型定义为指向 KeAcquireInStackQueuedSpinLock 函数的指针。然后,该示例声明此类型的 AcquireInStackQueuedSpinLock 变量。
... // // Pointer to the ordered spin lock function. // This function is only available on Windows 7 and // later systems typedef (* PAISQSL) (KeAcquireInStackQueuedSpinLock); PAISQSL AcquireInStackQueued = NULL; ...
此代码示例(驱动程序的初始化代码)确定驱动程序是否在 Windows 7 或更高版本的操作系统上运行。如果是,代码会检索指向 KeAcquireInStackQueuedSpinLock 的指针。
... // // Are we running on Windows 7 or later? // if (RtlIsNtDdiVersionAvailable(NTDDI_WIN7) ) { // // Yes... Windows 7 or later it is! // RtlInitUnicodeString(&funcName, L"KeAcquireInStackQueuedSpinLock"); // // Get a pointer to Windows implementation // of KeAcquireInStackQueuedSpinLock into our // variable "AcquireInStackQueued" AcquireInStackQueued = (PAISQSL) MmGetSystemRoutineAddress(&funcName); } ... // Acquire a spin lock. if( NULL != AcquireInStackQueued) { (AcquireInStackQueued)(&SpinLock, &lockHandle); } else { KeAcquireSpinLock(&SpinLock); }