Compartir a través de

Componentes de framework redistribuibles

  • Artículo

Nota:

Si el controlador solo tiene como destino Windows 10 o posterior, no es necesario redistribuir WDF ni proporcionar un Coinstaller en el paquete de controladores. Siga estos pasos:

  1. En Visual Studio, en la página de propiedades Configuración del proyecto, en Configuración del controlador ->Versión del sistema operativo de destino, seleccione Windows 10 o posterior. Esto equivale a agregar lo siguiente al archivo .vcxproj:
<PropertyGroup Label="Configuration">
<TargetVersion>Windows10</TargetVersion>
  1. En la sección Fabricante de INF, especifique 10.0 como versión del sistema operativo de destino, como se indica a continuación:
[Manufacturer]
%MyMfg% = MyMfg, NTamd64.10.0

En este tema se describen las actualizaciones del marco redistribuible proporcionadas por Microsoft que se incluyen como parte del Kit de controladores de Windows (WDK) y cómo determinar cuáles agregar al paquete de controladores.

Las actualizaciones del marco redistribuible permiten ejecutar un controlador compilado con una versión posterior del marco de trabajo que la incluida en un sistema operativo. Por ejemplo, KMDF 1.11 se incluye en Windows 8. Pero puedes ejecutar un controlador KMDF 1.11 en Windows Vista o Windows 7. Sin embargo, para poder hacerlo, debe asegurarse de que la biblioteca de marcos de KMDF 1.11 reemplaza la biblioteca de marcos incluida en el sistema operativo anterior (en este caso, KMDF 1.7 y KMDF 1.9 respectivamente). Para ello, redistribuya un archivo co-instalador o .msu proporcionado por Microsoft con el paquete de controladores.

¿Cuándo necesito incluir un co-instalador o .msu en mi paquete de controladores?

En primer lugar, decida qué versiones de Windows admitirá el controlador. En función de eso, determine qué versión de marco se va a usar.

Si la versión de WDF elegida es más reciente que la versión que se incluye con el sistema operativo de destino, incluya el archivo co-installer o .msu en el paquete de controladores.

Por ejemplo, quieres que el controlador se ejecute en Windows 7. Puede elegir compilar el controlador mediante WDF 1.11 o WDF 1.9. Si eliges la versión 1.9, que se proporciona con Windows 7, no es necesario actualizar el sistema. Por otro lado, si elige la versión 1.11, tendría que incluir un paquete de actualización de WDF 1.11 con el controlador.

¿Debo incluir el co-instalador o el archivo .msu?

Si la instalación del controlador se desencadena conectando un nuevo dispositivo de hardware a un sistema y va a instalar solo el controlador, incluya el coinstalación en el paquete de controladores. A continuación, haga referencia al co-instalador en el archivo INF, tal y como se describe en Especificación del co-instalador de KMDF en un archivo INF.

Si necesita instalar una aplicación además del controlador, debe redistribuir el paquete MSU correspondiente (por ejemplo, kmdf-1.11-Win.6.0.msu) junto con una aplicación de instalación que lo llame. En este caso, no se necesitan entradas INF.

Nunca necesita el co-instalador y el archivo .msu.

¿Dónde puedo encontrar estos archivos y lo que se incluye?

Estos archivos ya no se incluyen en el WDK. En su lugar, están disponibles como una descarga independiente del Centro de descarga de Microsoft. La página de descarga es componentes redistribuibles del Kit de controladores de Windows 8.

Después de la instalación, la MSU y los coinstaladores se pueden encontrar en %program files%\Windows Kits\8.0\redist\wdf.

Este directorio contiene los siguientes archivos para x86 y x64:

  • WdfCoinstaller01007.dll, WdfCoinstaller01009.dll, WdfCoinstaller01011.dll (co-installers para KMDF 1.7/1.9/1.11).
  • WUDFUpdate_01007.dll, WUDFUpdate_01009.dll, WUDFUpdate_01011.dll (co-installers para UMDF).
  • winusbcoinstaller.dll, winusbcoinstaller2.dll (co-installers para WinUSB 1.5/1.9).

Nomenclatura y control de versiones del co-instalador

El co-installer se denomina WdfCoInstallerMMmmm.dll.

  • MM es el número de versión principal.
  • mmm es el número de versión secundaria.

Por ejemplo, el nombre de archivo de la versión 1.0 del co-instalador es WdfCoInstaller01000.dll y el nombre de archivo de la versión 1.11 es WdfCoInstaller01011.dll.

La versión del co-instalador que incluya con el paquete de controladores debe coincidir con la versión de la biblioteca de marcos que usa para desarrollar el controlador.

Tenga en cuenta que el nombre de archivo de la biblioteca de marcos solo incluye el número de versión principal. Para obtener más información sobre los nombres de archivo de biblioteca, vea Control de versiones de la biblioteca de marcos.