Função DismAddDriver

Artigo
06/19/2023

Adiciona um driver de terceiros (.inf) a uma imagem offline do Windows.

Sintaxe

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

Parâmetros

Session [in]
Uma DismSession válida. A DismSession deve ser associada a uma imagem. Você pode associar uma sessão a uma imagem usando a função DismOpenSession .

DriverPath [in]
Um caminho relativo ou absoluto para o arquivo .inf do driver.

ForceUnsigned [in]
Um valor booliano que especifica se os drivers não assinados devem ser aceitos em uma imagem baseada em x64. Drivers não assinados serão adicionados automaticamente a uma imagem baseada em x86.

Valor	Descrição
TRUE	Adicione drivers não assinados a uma imagem baseada em x64.
FALSE	Não adicione drivers sem sinal a uma imagem baseada em x64.

Retornar valor

Retorna S_OK se há êxito.

Exemplos

Neste exemplo, o driver que está sendo adicionado está localizado no computador técnico na pasta C:\drivers\. O driver tem o nome de arquivo usb.inf no computador técnico, mas é renomeado como "OEM1.inf" ou "OEM2.inf" na imagem de destino. A numeração dos arquivos OEMx.inf depende do número de drivers adicionados. O novo nome, por exemplo, OEM1.inf, é retornado na estrutura DismDriverPackage quando você chama dismGetDrivers. Você deve usar o novo nome, OEM1.inf, para especificar o DriverPath ao usar o DismGetDriverInfo.

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

Requisitos

Requisito	Descrição
Plataformas de host com suporte	A API DISM pode ser usada em qualquer sistema operacional compatível com o Windows ADK (Kit de Avaliação e Implantação). Para obter mais informações, confira a Referência técnica do Windows ADK.
Plataformas de imagem com suporte	Windows 7, Windows Server 2008 R2, Windows PE 3.0, Windows 8, Windows Server 2012, Windows PE (Ambiente de Pré-Instalação do Windows) 4.0, Windows 8.1, Windows Server 2012 R2, Windows 10, Windows Server 2016
Cliente mínimo com suporte	Windows 7 [somente aplicativos da área de trabalho]
Servidor mínimo com suporte	Windows Server 2008 R2 [somente aplicativos da área de trabalho]
Cabeçalho	DismAPI.h
Biblioteca	DismAPI.lib
DLL	DismAPI.dll

Partilhar via