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

Consulte también

PsGetVersion