首页 > 代码库 > Windows 驱动程序工具包中的头文件
Windows 驱动程序工具包中的头文件
MSDN原文:https://msdn.microsoft.com/zh-cn/library/windows/hardware/ff554695(v=vs.85).aspx
Windows 驱动程序工具包 (WDK) 包含构建内核模式和用户模式驱动程序所需的所有头文件(.h 文件)。头文件在 WDK 安装文件夹中的 Include 文件夹中。示例:C:\Program Files (x86)\Windows Kits\10\Include。
头文件包含版本信息,因此不论驱动程序在哪个版本的 Windows 上运行,你都可以使用一组相同的头文件。
表示 Windows 版本的常量
WDK 中的头文件包含的条件语句指定编程元素仅在某些版本的 Windows 操作系统中才可用。进行版本管理的元素包括函数、枚举、结构以及结构成员。
若要指定编程元素在每个操作系统版本中都可用,头文件包含的预处理器条件将 NTDDI_VERSION 的值与 Sdkddkver.h 中定义的一组预定义常量值相比较。
以下是表示 Microsoft Windows 操作系统版本的预定义常量值。
常量 | 操作系统版本 |
---|---|
NTDDI_WIN10 |
Windows 10 |
NTDDI_WINBLUE |
Windows 8.1 |
NTDDI_WIN8 |
Windows 8 |
NTDDI_WIN7 |
Windows 7 |
NTDDI_WS08SP4 |
Windows Server 2008 SP4 |
NTDDI_WS08SP3 |
Windows Server 2008 SP3 |
NTDDI_WS08SP2 |
Windows Server 2008 SP2 |
NTDDI_WS08 |
Windows Server 2008 |
你可以在 WDK 头文件中看到特定于版本的 DDI 元素的多个示例。此条件声明出现在 Wdm.h 中,该文件为可能由内核模式驱动程序包含的头文件。
#if (NTDDI_VERSION >= NTDDI_WIN7) _Must_inspect_result_ NTKERNELAPI NTSTATUS KeSetTargetProcessorDpcEx ( _Inout_ PKDPC Dpc, _In_ PPROCESSOR_NUMBER ProcNumber ); #endif
在该示例中,你可以看到仅在 Windows 7 和更高版本的 Windows 中才提供 KeSetTargetProcessorDpcEx 函数。
此条件声明出现在 Winspool.h 中,该文件为可能由用户模式驱动程序包含的头文件。
#if (NTDDI_VERSION >= NTDDI_WIN7) ... BOOL WINAPI GetPrintExecutionData( _Out_ PRINT_EXECUTION_DATA *pData ); #endif // (NTDDI_VERSION >= NTDDI_WIN7)
在该示例中,你可以看到仅在 Windows 7 和更高版本的 Windows 中才提供 GetPrintExecutionData 函数。
用于内核模式驱动程序框架的头文件
WDK 支持多种版本的 Windows,并且它还支持多种版本的内核模式驱动程序框架 (KMDF) 和用户模式驱动程序框架 (UMDF)。WDK 头文件中的版本信息与 Windows 版本有关,但与 KMDF 或 UMDF 版本无关。用于不同版本的 KMDF 和 UMDF 的头文件放置在不同的目录中。
Windows 驱动程序工具包中的头文件