Função WdfPreDeviceInstallEx (wdfinstaller.h)
[Aplica-se somente ao KMDF]
A função WdfPreDeviceInstallEx do co-instalador executa todas as operações que o co-instalador pode exigir antes que o instalador de um driver não Plug and Play (PnP) crie o serviço de modo kernel do driver.
Sintaxe
ULONG WdfPreDeviceInstallEx(
[in] LPCWSTR InfPath,
[in, optional] LPCWSTR InfSectionName,
[in] PWDF_COINSTALLER_INSTALL_OPTIONS ClientOptions
);
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.
[in] ClientOptions
Um ponteiro para uma estrutura do tipo WDF_COINSTALLER_INSTALL_OPTIONS alocada pelo chamador que contém opções de instalação especificadas pelo driver.
Retornar valor
WdfPreDeviceInstallEx retornará ERROR_SUCCESS se a operação for bem-sucedida. Caso contrário, a função retornará um dos valores adicionais ERROR_XXX 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 WdfPreDeviceInstallEx 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), a função WdfPreDeviceInstallEx permite controlar quando ou se o usuário é solicitado a reiniciar o computador, da seguinte maneira:
- Se o instalador definir o membro ShowRebootPrompt da estrutura WDF_COINSTALLER_INSTALL_OPTIONS como TRUE, WdfPreDeviceInstallEx informará ao gerenciador PnP que o computador deve ser reiniciado e o gerenciador PnP solicitará ao usuário que uma reinicialização seja necessária. Definir o membro ShowRebootPrompt como TRUE é equivalente a chamar WdfPreDeviceInstall.
- Se o instalador definir o membro ShowRebootPrompt da estrutura WDF_COINSTALLER_INSTALL_OPTIONS como FALSE, WdfPreDeviceInstallEx não informará ao gerenciador PnP que uma reinicialização é necessária. Em vez disso, a função retorna ERROR_SUCCESS_REBOOT_REQUIRED. O instalador pode determinar quando ou se deve reiniciar o computador,
Exemplos
Para obter um exemplo de código que usa a função WdfPreDeviceInstallEx , consulte o instalador para o exemplo NONPNP .
Requisitos
| Requisito | Valor |
|---|---|
| Plataforma de Destino | Universal |
| Versão mínima do KMDF | 1,9 |
| Cabeçalho | wdfinstaller.h (inclua Wdfinstaller.h) |
| Biblioteca | N/A (exportado pela biblioteca de co-instalador kmdf. Para obter informações sobre o nome do arquivo da biblioteca do co-instalador, consulte Usando o co-instalador KMDF.) |