Función DismAddDriver

Agrega un controlador de terceros (.inf) a una imagen de Windows sin conexión.

Sintaxis

HRESULT WINAPI DismAddDriver(
  _In_ DismSession Session,
  _In_ PCWSTR      DriverPath,
  _In_ BOOL        ForceUnsigned
);

Parámetros

Sesión [in]
Valor de DismSession válido. DismSession debe estar asociado a una imagen. Puede asociar una sesión a una imagen mediante la función DismOpenSession .

DriverPath [in]
Ruta de acceso relativa o absoluta al archivo .inf del controlador.

ForceUnsigned [in]
Valor booleano que especifica si se deben aceptar controladores sin firmar en una imagen basada en x64. Los controladores sin firmar se agregarán automáticamente a una imagen basada en x86.

Valor	Descripción
true	Agregue controladores sin firmar a una imagen basada en x64.
false	No agregue controladores sin firmar a una imagen basada en x64.

Valor devuelto

Si se descarga correctamente, devuelve S_OK .

Ejemplos

En este ejemplo, el controlador que se va a agregar se encuentra en el equipo técnico de la carpeta C:\drivers\. El controlador tiene el nombre de archivo usb.inf en el equipo técnico, pero se cambia el nombre a "OEM1.inf" o "OEM2.inf" en la imagen de destino. La numeración de los archivos OEMx.inf depende del número de controladores agregados. El nuevo nombre, por ejemplo OEM1.inf, se devuelve en la estructura DismDriverPackage cuando se llama a DismGetDrivers. Debe usar el nuevo nombre, OEM1.inf, para especificar DriverPath al usar DismGetDriverInfo.

HRESULT hr = S_OK;
hr = DismAddDriver(Session, L"C:\\Drivers\\usb.inf", FALSE);

Requisitos

Requisito	Descripción
Plataformas host soportadas	La API de DISM puede usarse en cualquier sistema operativo que el Windows Assessment and Deployment Kit (Windows ADK) admita. Para obtener más información, consulta la Referencia técnica de Windows ADK.
Plataformas de imágenes soportadas	Windows 7, Windows Server 2008 R2, Windows PE 3.0, Windows 8, Windows Server 2012, Entorno de Preinstalación de Windows (Windows PE) 4.0, Windows 8.1, Windows Server 2012 R2, Windows 10 y Windows Server 2016
Cliente mínimo compatible	Windows 7 [solo aplicaciones de escritorio]
Servidor mínimo compatible	Windows Server 2008 R2 [solo aplicaciones de escritorio]
Encabezado	DismAPI.h
Biblioteca	DismAPI.lib
Archivo DLL	DismAPI.dll