Função WdfPreDeviceInstall (wdfinstaller.h)

[Aplica-se somente ao KMDF]

A função WdfPreDeviceInstall do co-instalador executa todas as operações que o co-instalador pode exigir antes que um instalador de driver não Plug and Play (PnP) crie o serviço de modo kernel do driver.

Sintaxe

ULONG WdfPreDeviceInstall(
  [in]           LPCWSTR InfPath,
  [in, optional] LPCWSTR InfSectionName
);

Parâmetros

[in] InfPath

Um ponteiro para uma cadeia de caracteres largos terminada em nulo que contém o caminho do diretório para o arquivo INF do driver. O instalador do driver pode obter essa cadeia de caracteres chamando GetCurrentDirectory, que é descrito no SDK do Microsoft Windows.

[in, optional] InfSectionName

Um ponteiro para uma cadeia de caracteres largos terminada em nulo que contém o nome Wdf-install-section no arquivo INF do driver. Para obter mais informações sobre esse nome, consulte Usando o co-instalador KMDF. Se esse ponteiro for NULL, o co-instalador usará WdfSection para o nome.

Retornar valor

WdfPreDeviceInstall retornará ERROR_SUCCESS se a operação for bem-sucedida. Caso contrário, a função retornará um dos valores de ERROR_XXX adicionais definidos em Winerror.h.

Comentários

O instalador para os drivers baseados em estrutura de um dispositivo não PnP deve chamar WdfPreDeviceInstall ou WdfPreDeviceInstallEx antes que o instalador chame CreateService.

Para obter o endereço da função WdfPreDeviceInstall do co-instalador, o instalador deve chamar GetProcAddress depois que o instalador tiver chamado LoadLibrary para carregar o co-instalador.

Se o co-instalador determinar que o computador deve ser reiniciado para concluir a instalação do driver (normalmente porque uma versão mais antiga da estrutura foi instalada anteriormente), wdfPreDeviceInstall informará o gerenciador de Plug and Play (PnP). Em seguida, o gerenciador PnP solicita ao usuário que uma reinicialização seja necessária.

Para obter mais informações sobre a função WdfPreDeviceInstall e instaladores para drivers baseados em estrutura de dispositivos não PnP, consulte Instalando um driver não PnP. Para obter mais informações sobre CreateService, GetProcAddress e LoadLibrary, consulte a documentação do SDK do Microsoft Windows.

Exemplos

Para obter um exemplo de código que usa a função WdfPreDeviceInstall , consulte o instalador do exemplo NONPNP .

Requisitos

Requisito	Valor
Plataforma de Destino	Universal
Versão mínima do KMDF	1.0
Cabeçalho	wdfinstaller.h (include Wdfinstaller.h)
Biblioteca	N/D (exportado pela biblioteca do co-instalador KMDF. Para obter informações sobre o nome de arquivo da biblioteca do co-instalador, consulte Usando o co-instalador KMDF.)

Confira também

WdfPostDeviceInstall