Поделиться через


Управление версиями библиотеки платформы

В этом разделе вы узнаете о соглашениях об именовании для имен файлов библиотеки Kernel-Mode Driver Framework (KMDF) и библиотеки User-Mode Driver Framework (UMDF).

KMDF

Номера основной версии и дополнительный номер версии назначаются каждой версии библиотеки KMDF. Имя файла библиотеки содержит основной номер версии. Формат имени файла:

Wdf<MajorVersionNumber>000.sys

Основной номер версии использует два символа. Например, имя файла библиотеки версии 1.0 — Wdf01000.sys. Версии 1.9, 1.11 и т. д. также называются Wdf01000.sys, и каждая новая дополнительная версия файла библиотеки перезаписывает предыдущую версию файла.

Если вы создали драйвер с помощью версии библиотеки KMDF, которая является более поздней, чем версия платформы в системе, то последнюю версию необходимо обновить. Сведения об обновлении библиотеки платформы см. в разделе Компоненты распространяемой платформы.

(Обратите внимание, что имя файла совместного установщика платформы включает номера основной и дополнительной версии. Дополнительные сведения об именах файлов совместного установщика см. в разделе Использование совместного установщика KMDF.)

При сборке драйвера служебная программа MSBuild связывает драйвер с файлом заглушки, который содержит номер версии библиотеки, используемой служебной программой MSBuild. Когда операционная система загружает драйвер, загрузчик платформы проверяет сведения о версии в заглушку драйвера, чтобы определить, будет ли драйвер работать с версией библиотеки платформы, которая находится в системе.

Чтобы определить версию библиотеки, с которым работает драйвер, драйвер может вызвать WdfDriverIsVersionAvailable или WdfDriverRetrieveVersionString.

WDF позволяет создать драйвер, используя версию Windows, отличную от версии, в которой будет работать драйвер. Дополнительные сведения см. в статье Создание драйвера WDF для нескольких версий Windows.

Сведения о журнале выпусков библиотеки KMDF см. в разделе Журнал версий KMDF.

UMDF

Как и в случае с KMDF, основной номер версии библиотеки UMDF использует два символа. Однако основной номер версии отображается только в имени файла библиотеки UMDF, начиная с UMDF версии 2.0.

Для UMDF версии 2.0 имя файла библиотеки UMDF равно Wudfx02000.dll.

Для UMDF версии 1. x, имя файла библиотеки UMDF — Wudfx.dll.

Сведения о журнале выпусков библиотеки KMDF см. в разделе Журнал версий UMDF.