rtlGetVersion 函数 (wdm.h)

RtlGetVersion 例程返回有关当前正在运行的操作系统的版本信息。

语法

NTSYSAPI NTSTATUS RtlGetVersion(
  [out] PRTL_OSVERSIONINFOW lpVersionInformation
);

参数

[out] lpVersionInformation

指向 RTL_OSVERSIONINFOW 结构或包含当前正在运行的操作系统的版本信息的 RTL_OSVERSIONINFOEXW 结构的指针。 调用方通过将结构的 dwOSVersionInfoSize 成员设置为所用结构的大小(以字节为单位)来指定使用哪个输入结构。

返回值

RtlGetVersion 返回STATUS_SUCCESS。

注解

RtlGetVersion 是 Windows SDK 中用户模式 GetVersionEx 函数的内核模式等效项。 请参阅 Windows SDK 中的示例,该示例演示如何获取系统版本。

使用 RtlGetVersion 确定操作系统的特定版本是否正在运行时,调用方应检查大于或等于所需版本号的版本号。 这可确保更高版本的 Windows 的版本测试成功。

由于操作系统功能可以添加到可再发行 DLL 中,因此仅检查主要版本号和次要版本号并不是验证是否存在特定系统功能的最可靠方法。 驱动程序应使用 RtlVerifyVersionInfo 来测试是否存在特定系统功能。

要求

要求
最低受支持的客户端 从 Windows 2000 开始可用。
目标平台 通用
标头 wdm.h (包括 Ntddk.h)
Library NtosKrnl.lib
DLL NtosKrnl.exe
IRQL PASSIVE_LEVEL

另请参阅

PsGetVersion