Função WdfPreDeviceRemove (wdfinstaller.h)
[Aplica-se somente ao KMDF]
A função WdfPreDeviceRemove 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) exclua o serviço de modo kernel do driver.
Sintaxe
ULONG WdfPreDeviceRemove(
[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
WdfPreDeviceRemove 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 WdfPreDeviceRemove antes que o instalador chame DeleteService.
Para obter o endereço da função WdfPreDeviceRemove do co-instalador, o instalador deve chamar GetProcAddress depois que o instalador tiver chamado LoadLibrary para carregar o co-instalador.
Para obter mais informações sobre a função WdfPreDeviceRemove 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 DeleteService, 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 WdfPreDeviceRemove , 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.) |