Wersjonowanie biblioteki frameworku

W tym temacie poznasz konwencje nazewnictwa nazw plików biblioteki Kernel-Mode Driver Framework (KMDF) i biblioteki User-Mode Driver Framework (UMDF).

KMDF

Numer wersji głównej i numer wersji pomocniczej są przypisywane do każdej wersji biblioteki KMDF. Nazwa pliku biblioteki zawiera numer wersji głównej. Format nazwy pliku to:

Wdf<MajorVersionNumber>000.sys

Numer wersji głównej używa dwóch znaków. Na przykład nazwa pliku dla wersji 1.0 biblioteki to Wdf01000.sys. Wersje 1.9, 1.11 i tak dalej są również nazywane Wdf01000.sys, a każda nowa wersja pomocnicza pliku biblioteki zastępuje poprzednią wersję pliku.

Jeśli sterownik został skompilowany przy użyciu wersji biblioteki KMDF nowszej niż wersja platformy, która znajduje się w systemie, należy zaktualizować tę ostatnią wersję. Aby uzyskać informacje na temat aktualizowania biblioteki platformy, zobacz Redistributable Framework Components.

(Należy pamiętać, że nazwa pliku współinstalatora struktury zawiera zarówno numery wersji głównej, jak i pomocniczej. Aby uzyskać więcej informacji na temat nazw plików współinstalatora, zobacz Using the KMDF Co-installer.)

Podczas kompilowania sterownika narzędzie MSBuild łączy sterownik z plikiem wycinkowym zawierającym numer wersji biblioteki używanej przez narzędzie MSBuild. Gdy system operacyjny ładuje sterownik, moduł ładujący platformy sprawdza informacje o wersji w wycinku sterownika, aby określić, czy sterownik zostanie uruchomiony z wersją biblioteki struktury, która znajduje się w systemie.

Aby określić wersję biblioteki uruchomionej przez sterownik, sterownik może wywołać WdfDriverIsVersionAvailable lub WdfDriverRetrieveVersionString.

Windows Driver Framework (WDF) pozwala na tworzenie sterownika przy użyciu innej wersji systemu Windows niż ta, na której sterownik będzie działać. Aby uzyskać więcej informacji, zobacz Projektowanie sterownika WDF dla wielu wersji systemu Windows.

Aby uzyskać informacje o historii wersji biblioteki KMDF, zobacz Historia wersji KMDF.

UMDF

Podobnie jak w przypadku usługi KMDF numer wersji głównej biblioteki UMDF używa dwóch znaków. Jednak numer wersji głównej jest wyświetlany tylko w nazwie pliku biblioteki UMDF, począwszy od UMDF w wersji 2.0.

W przypadku usługi UMDF w wersji 2.0 nazwa pliku biblioteki UMDF jest Wudfx02000.dll.

Dla UMDF w wersji 1.x, nazwa pliku biblioteki UMDF to Wudfx.dll.

Aby uzyskać informacje o historii wersji biblioteki KMDF, odwiedź historię wersji UMDF.