(wdm.h) RtlGetVersion 函式
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 開始提供。 |
目標平台 | Universal |
標頭 | wdm.h (包含 Ntddk.h) |
程式庫 | NtosKrnl.lib |
Dll | NtosKrnl.exe |
IRQL | PASSIVE_LEVEL |