Windows内核驱动开发时是否要设置版本控制宏

Windows内核驱动开发时是否要设置版本控制宏

不是必须的，但在专业开发中强烈推荐设置，否则会带来很多问题。

1. 如果不设置会怎样？

默认情况下，编译器会使用最低版本的 Windows API 定义（通常是 Windows 2000 或 XP 级别）。这会导致：

// 如果没有定义 NTDDI_VERSION
#include <wdm.h>

// 你可能无法使用新版本 API
NTSTATUS MyFunction() {
// Windows 10 新增的函数
NTSTATUS status = SomeWindows10Api(); // ❌ 编译错误：未声明的标识符

// 或者结构体字段不全
PDEVICE_OBJECT device;
device->SomeNewField = 1; // ❌ 编译错误：没有此成员
}

2. 什么时候必须设置？

3. 正确的设置方法

3.1 在 targetver.h 中统一设置（推荐）

// targetver.h
#pragma once

// 目标 Windows 10 1909
#define NTDDI_VERSION NTDDI_WIN10_19H1
#define _WIN32_WINNT 0x0A00
#define WINVER 0x0A00

3.2 在项目属性中设置

• VS -> 项目属性 -> C/C++ -> 预处理器 -> 预处理器定义
• 添加：NTDDI_VERSION=NTDDI_WIN10_19H1;_WIN32_WINNT=0x0A00;WINVER=0x0A00

3.3 在源文件开头设置

// Driver.h
#include <ntddk.h>

// 必须在包含 wdm.h/ntddk.h 之前定义
#define NTDDI_VERSION NTDDI_WIN10_RS3
#define _WIN32_WINNT 0x0A00
#define WINVER 0x0A00

#include <wdm.h>
// 现在可以使用 Windows 10 RS3 的所有 API

4. 各版本宏的值