MSDN原文:https://msdn.microsoft.com/zh-cn/library/windows/hardware/ff554887(v=vs.85).aspx
创建驱动程序项目时,指定基本的目标操作系统,该系统是运行驱动程序的基本版本的 Windows。例如,你可以指定 Windows 7 为基本的目标操作系统。在这种情况下,驱动程序会在 Windows 7 和更高版本的 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 和更高版本的操作系统版本上提供了此函数。
示例:确定 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);
}
在该示例中,驱动程序调用 RtlIsNtDdiVersionAvailable 以确定驱动程序是否在 Windows 7 或更高版本上运行。如果版本为 Windows 7 或更高版本,驱动程序将会调用 MmGetSystemRoutineAddress 来获取指向 KeAcquireInStackQueuedSpinLock 函数的指针并将此指针存储在名为 AcquireInStackQueued
的变量(该变量声明为 PAISQSL 类型)中。
然后,当驱动程序必须获取旋转锁时,它会检查是否收到指向 KeAcquireInStackQueuedSpinLock 函数的指针。如果驱动程序已收到此指针,则驱动程序会使用该指针调用 KeAcquireInStackQueuedSpinLock。如果指向 KeAcquireInStackQueuedSpinLock 的指针为 Null,则驱动程序会使用 KeAcquireSpinLock 来获取旋转锁。