Fungsi RtlGetVersion (wdm.h)
Rutinitas RtlGetVersion mengembalikan informasi versi tentang sistem operasi yang sedang berjalan.
Sintaks
NTSYSAPI NTSTATUS RtlGetVersion(
[out] PRTL_OSVERSIONINFOW lpVersionInformation
);
Parameter
[out] lpVersionInformation
Arahkan ke struktur RTL_OSVERSIONINFOW atau struktur RTL_OSVERSIONINFOEXW yang berisi informasi versi tentang sistem operasi yang sedang berjalan. Pemanggil menentukan struktur input mana yang digunakan dengan mengatur anggota dwOSVersionInfoSize struktur ke ukuran dalam byte struktur yang digunakan.
Nilai kembali
RtlGetVersion mengembalikan STATUS_SUCCESS.
Keterangan
RtlGetVersion adalah mode kernel yang setara dengan fungsi GetVersionEx mode pengguna di Windows SDK. Lihat contoh di Windows SDK yang menunjukkan cara mendapatkan versi sistem.
Saat menggunakan RtlGetVersion untuk menentukan apakah versi tertentu dari sistem operasi berjalan, pemanggil harus memeriksa nomor versi yang lebih besar dari atau sama dengan nomor versi yang diperlukan. Ini memastikan bahwa pengujian versi berhasil untuk versi Windows yang lebih baru.
Karena fitur sistem operasi dapat ditambahkan dalam DLL yang dapat didistribusikan ulang, hanya memeriksa nomor versi utama dan minor bukanlah cara yang paling dapat diandalkan untuk memverifikasi keberadaan fitur sistem tertentu. Driver harus menggunakan RtlVerifyVersionInfo untuk menguji keberadaan fitur sistem tertentu.
Persyaratan
| Persyaratan | Nilai |
|---|---|
| Klien minimum yang didukung | Tersedia dimulai dengan Windows 2000. |
| Target Platform | Universal |
| Header | wdm.h (termasuk Ntddk.h) |
| Pustaka | NtosKrnl.lib |
| DLL | NtosKrnl.exe |
| IRQL | PASSIVE_LEVEL |