Partilhar via


Função DismGetDriverInfo

Obtém informações sobre um arquivo .inf em uma imagem especificada.

Sintaxe

HRESULT WINAPI DismGetDriverInfo(
  _In_      DismSession       Session,
  _In_      PCWSTR            DriverPath,
  _Out_     DismDriver        **Driver,
  _Out_     UINT              *Count,
  _Out_opt_ DismDriverPackage **DriverPackage
);

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 DismOpenSession.

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

Driver [out]
O endereço de um ponteiro para uma matriz de estruturas dismDriver .

Count [out]
Retorna o número de estruturas dismDriver que foram retornadas.

DriverPackage [out, opcional]
Opcional. Um ponteiro para o endereço de uma estrutura DismDriverPackage .

Retornar valor

Retorna S_OK se há êxito.

Comentários

Essa função retorna informações sobre o arquivo .inf instalado na imagem. O driver associado ao arquivo .inf pode ou não estar instalado na imagem.

Exemplo

HRESULT hr = S_OK;
DismDriverInfo* DriverInfo;
UINT Count;
hr = DismGetDriverInfo(Session, L"usb.inf", &DriverInfo, &Count, &DriverPackageInfo);

Requisitos

Exigência 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

Confira também

DismGetDrivers

DismAddDriver

DismRemoveDriver

DismDelete