Función RtlGetVersion (wdm.h)
La rutina RtlGetVersion devuelve información de versión sobre el sistema operativo que se está ejecutando actualmente.
Sintaxis
NTSYSAPI NTSTATUS RtlGetVersion(
[out] PRTL_OSVERSIONINFOW lpVersionInformation
);
Parámetros
[out] lpVersionInformation
Puntero a una estructura de RTL_OSVERSIONINFOW o a una estructura de RTL_OSVERSIONINFOEXW que contiene la información de versión sobre el sistema operativo que se está ejecutando actualmente. Un llamador especifica qué estructura de entrada se usa estableciendo el miembro dwOSVersionInfoSize de la estructura en el tamaño en bytes de la estructura que se usa.
Valor devuelto
RtlGetVersion devuelve STATUS_SUCCESS.
Comentarios
RtlGetVersion es el equivalente en modo kernel de la función GetVersionEx en modo de usuario en Windows SDK. Vea el ejemplo de Windows SDK que muestra cómo obtener la versión del sistema.
Al usar RtlGetVersion para determinar si se está ejecutando una versión determinada del sistema operativo, un llamador debe comprobar si hay números de versión mayores o iguales que el número de versión necesario. Esto garantiza que una prueba de versión se realice correctamente para versiones posteriores de Windows.
Dado que las características del sistema operativo se pueden agregar en un archivo DLL redistribuible, comprobar solo los números de versión principal y secundaria no es la manera más confiable de comprobar la presencia de una característica específica del sistema. Un controlador debe usar RtlVerifyVersionInfo para probar la presencia de una característica específica del sistema.
Requisitos
| Requisito | Value |
|---|---|
| Cliente mínimo compatible | Disponible a partir de Windows 2000. |
| Plataforma de destino | Universal |
| Encabezado | wdm.h (incluya Ntddk.h) |
| Library | NtosKrnl.lib |
| Archivo DLL | NtosKrnl.exe |
| IRQL | PASSIVE_LEVEL |