Compartir vía


Control de versiones de la biblioteca de marcos

En este tema, obtendrá información sobre las convenciones de nomenclatura para los nombres de archivo de la biblioteca de Kernel-Mode Driver Framework (KMDF) y la biblioteca de User-Mode Driver Framework (UMDF).

KMDF

Se asigna un número de versión principal y un número de versión secundaria a cada versión de la biblioteca KMDF. El nombre de archivo de la biblioteca contiene el número de versión principal. El formato del nombre de archivo es:

Rdf<MajorVersionNumber>000.sys

El número de versión principal usa dos caracteres. Por ejemplo, el nombre de archivo de la versión 1.0 de la biblioteca es Wdf01000.sys. Las versiones 1.9, 1.11, etc., también se denominan Wdf01000.sysy cada nueva versión secundaria del archivo de biblioteca sobrescribe la versión anterior del archivo.

Si ha compilado el controlador con una versión de la biblioteca KMDF que es más reciente que la versión del marco que está en el sistema, este último debe actualizarse. Para obtener información sobre cómo actualizar la biblioteca de marcos, vea Redistributable Framework Components.

(Tenga en cuenta que el nombre de archivo del co-instalador del marco incluye los números de versión principal y secundaria. Para obtener más información sobre los nombres de archivo co-instalador, vea Using the KMDF Co-installer).

Al compilar el controlador, la utilidad de MSBuild vincula el controlador con un archivo de código auxiliar que contiene el número de versión de la biblioteca que usó la utilidad de MSBuild. Cuando el sistema operativo carga el controlador, el cargador del marco comprueba la información de versión en el código auxiliar del controlador para determinar si el controlador se ejecutará con la versión de la biblioteca de marcos que se encuentra en el sistema.

Para determinar la versión de la biblioteca con la que se ejecuta el controlador, el controlador puede llamar a WdfDriverIsVersionAvailable o WdfDriverRetrieveVersionString.

WDF permite compilar un controlador con una versión diferente de Windows a la que ejecutará el controlador. Para obtener más información, consulta Creación de un controlador WDF para varias versiones de Windows.

Para obtener información sobre el historial de versiones de la biblioteca de KMDF, vea Historial de versiones de KMDF.

UMDF

Al igual que con KMDF, el número de versión principal de la biblioteca UMDF usa dos caracteres. Sin embargo, el número de versión principal solo aparece en el nombre del archivo de biblioteca UMDF a partir de la versión 2.0 de UMDF.

Para la versión 2.0 de UMDF, el nombre de archivo de la biblioteca UMDF es Wudfx02000.dll.

Para la versión 1 de UMDF. x, el nombre de archivo de la biblioteca UMDF es Wudfx.dll.

Para obtener información sobre el historial de versiones de la biblioteca KMDF, consulte Historial de versiones de UMDF.