WdfPreDeviceRemove, fonction (wdfinstaller.h)

Article
08/08/2023

[S’applique uniquement à KMDF]

La fonction WdfPreDeviceRemove du co-programme d’installation effectue toutes les opérations dont le co-programme d’installation peut avoir besoin avant que le programme d’installation d’un pilote non Plug-and-Play (PnP) supprime le service en mode noyau du pilote.

Syntaxe

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

Paramètres

[in] InfPath

Pointeur vers une chaîne de caractères larges terminée par null qui contient le chemin du répertoire du fichier INF du pilote. Le programme d’installation du pilote peut obtenir cette chaîne en appelant GetCurrentDirectory, qui est décrit dans le Microsoft Windows SDK.

[in, optional] InfSectionName

Pointeur vers une chaîne de caractères larges terminée par null qui contient le nom de section Wdf-install-section dans le fichier INF du pilote. Pour plus d’informations sur ce nom, consultez Utilisation du co-programme d’installation KMDF. Si ce pointeur a la valeur NULL, le co-programme d’installation utilise WdfSection pour le nom.

Valeur retournée

WdfPreDeviceRemove retourne ERROR_SUCCESS si l’opération réussit. Sinon, la fonction retourne l’une des valeurs ERROR_XXX supplémentaires définies dans Winerror.h.

Remarques

Le programme d’installation des pilotes basés sur l’infrastructure d’un appareil non PnP doit appeler WdfPreDeviceRemove avant que le programme d’installation appelle DeleteService.

Pour obtenir l’adresse de la fonction WdfPreDeviceRemove du co-programme d’installation, le programme d’installation doit appeler GetProcAddress après que le programme d’installation a appelé LoadLibrary pour charger le co-programme d’installation.

Pour plus d’informations sur la fonction WdfPreDeviceRemove et les programmes d’installation des pilotes basés sur l’infrastructure d’appareils non PnP, consultez Installation d’un pilote non PnP. Pour plus d’informations sur DeleteService, GetProcAddress et LoadLibrary, consultez la documentation Microsoft Windows SDK.

Exemples

Pour obtenir un exemple de code qui utilise la fonction WdfPreDeviceRemove , consultez le programme d’installation de l’exemple NONPNP .

Configuration requise

Condition requise	Valeur
Plateforme cible	Universal
Version KMDF minimale	1.0
En-tête	wdfinstaller.h (inclure Wdfinstaller.h)
Bibliothèque	N/A (Exporté par la bibliothèque de co-programme d’installation KMDF. Pour plus d’informations sur le nom de fichier de la bibliothèque de co-programme d’installation, consultez Utilisation du co-programme d’installation KMDF.)

Voir aussi

WdfPostDeviceRemove

Partager via