Versionamento de Bibliotecas de Framework
Neste tópico, você aprenderá sobre as convenções de nomenclatura para os nomes de arquivo da biblioteca KMDF (Kernel-Mode Driver Framework) e da biblioteca 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 da versão principal. O formato do nome do ficheiro é:
Wdf<MajorVersionNumber>000.sys
O número da versão principal usa dois caracteres. Por exemplo, o nome do arquivo para a 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.sys, e cada nova versão secundária do arquivo de biblioteca substitui a versão anterior do arquivo.
Se você criou seu driver usando uma versão da biblioteca KMDF que é mais recente do que a versão da estrutura que está no sistema, então o último deve ser atualizado. Para obter informações sobre como atualizar a biblioteca de estruturas, consulte Redistributable Framework Components.
(Observe que o nome do arquivo do coinstalador da estrutura inclui os números de versão principal e secundária. Para obter mais informações sobre nomes de arquivo de coinstalador, consulte Usando o coinstalador KMDF.)
Quando você cria o driver, o utilitário MSBuild vincula o driver com um arquivo de stub que contém o número da versão da biblioteca que o utilitário MSBuild usou. 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 da estrutura 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.
WDF permite que você crie um driver usando uma versão do Windows diferente daquela 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ões do KMDF.
UMDF
Assim como no KMDF, o número da versão principal da biblioteca UMDF usa dois caracteres. No entanto, o número da versão principal só aparece no nome do arquivo da biblioteca UMDF começando com UMDF versão 2.0.
Para UMDF versão 2.0, o nome de 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ões do UMDF.