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

В этом разделе вы узнаете о соглашениях об именовании файлов библиотеки 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, начиная с версии 2.0.

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

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

Для получения информации об истории выпусков библиотеки KMDF см. историю версий UMDF.