Função RtlGetVersion (wdm.h)
A rotina RtlGetVersion retorna informações de versão sobre o sistema operacional em execução no momento.
Sintaxe
NTSYSAPI NTSTATUS RtlGetVersion(
[out] PRTL_OSVERSIONINFOW lpVersionInformation
);
Parâmetros
[out] lpVersionInformation
Ponteiro para uma estrutura RTL_OSVERSIONINFOW ou uma estrutura RTL_OSVERSIONINFOEXW que contém as informações de versão sobre o sistema operacional em execução no momento. Um chamador especifica qual estrutura de entrada é usada definindo o membro dwOSVersionInfoSize da estrutura para o tamanho em bytes da estrutura usada.
Retornar valor
RtlGetVersion retorna STATUS_SUCCESS.
Comentários
RtlGetVersion é o equivalente ao modo kernel da função GetVersionEx no modo de usuário no SDK do Windows. Confira o exemplo no SDK do Windows que mostra como obter a versão do sistema.
Ao usar RtlGetVersion para determinar se uma versão específica do sistema operacional está em execução, um chamador deve marcar para números de versão maiores ou iguais ao número de versão necessário. Isso garante que um teste de versão seja bem-sucedido para versões posteriores do Windows.
Como os recursos do sistema operacional podem ser adicionados em uma DLL redistribuível, verificar apenas os números de versão principal e secundária não é a maneira mais confiável de verificar a presença de um recurso específico do sistema. Um driver deve usar RtlVerifyVersionInfo para testar a presença de um recurso específico do sistema.
Requisitos
Requisito | Valor |
---|---|
Cliente mínimo com suporte | Disponível a partir do Windows 2000. |
Plataforma de Destino | Universal |
Cabeçalho | wdm.h (inclua Ntddk.h) |
Biblioteca | NtosKrnl.lib |
DLL | NtosKrnl.exe |
IRQL | PASSIVE_LEVEL |