Controle de versão da biblioteca de estruturas

Neste tópico, você aprenderá sobre as convenções de nomenclatura para os nomes de arquivo da biblioteca do KMDF (Kernel-Mode Driver Framework) e a biblioteca do UMDF (User-Mode Driver Framework).

KMDF

Um número de versão principal e um número de versão secundária são atribuídos a cada versão da biblioteca KMDF. O nome do arquivo da biblioteca contém o número de versão principal. O formato do nome do arquivo é:

Wdf<MajorVersionNumber>000.sys

O número de versão principal usa dois caracteres. Por exemplo, o nome do arquivo da versão 1.0 da biblioteca é Wdf01000.sys. As versões 1.9, 1.11 e assim por diante também são nomeadas Wdf01000.syse cada nova versão secundária do arquivo de biblioteca substitui a versão anterior do arquivo.

Se você criou o driver usando uma versão da biblioteca KMDF mais recente do que a versão da estrutura que está no sistema, a última deverá ser atualizada. Para obter informações sobre como atualizar a biblioteca de estruturas, consulte Componentes da Estrutura Redistribuível.

(Observe que o nome do arquivo do co-instalador da estrutura inclui os números de versão principal e secundária. Para obter mais informações sobre nomes de arquivos do co-instalador, consulte Usando o co-instalador KMDF.)

Quando você cria o driver, o utilitário MSBuild vincula o driver a um arquivo stub que contém o número de versão da biblioteca usada pelo utilitário MSBuild. Quando o sistema operacional carrega o driver, o carregador da estrutura verifica as informações de versão no stub do driver para determinar se o driver será executado com a versão da biblioteca de estruturas que está no sistema.

Para determinar a versão da biblioteca com a qual o driver está sendo executado, o driver pode chamar WdfDriverIsVersionAvailable ou WdfDriverRetrieveVersionString.

O WDF permite que você crie um driver usando uma versão diferente do Windows em que o driver será executado. Para obter mais informações, consulte Criando um driver WDF para várias versões do Windows.

Para obter informações sobre o histórico de lançamento da biblioteca KMDF, consulte Histórico de versão do KMDF.

UMDF

Assim como no KMDF, o número de versão principal da biblioteca UMDF usa dois caracteres. No entanto, o número de versão principal só aparece no nome do arquivo da biblioteca UMDF começando com UMDF versão 2.0.

Para o UMDF versão 2.0, o nome do arquivo da biblioteca UMDF é Wudfx02000.dll.

Para UMDF versão 1. x, o nome do arquivo da biblioteca UMDF é Wudfx.dll.

Para obter informações sobre o histórico de lançamento da biblioteca KMDF, consulte Histórico de versão do UMDF.