Fonction WdfPostDeviceRemove (wdfinstaller.h)

Article
02/27/2024

[S’applique uniquement à KMDF]

La fonction WdfPostDeviceRemove du co-programme d’installation effectue toutes les opérations dont le co-programme d’installation peut avoir besoin après que le programme d’installation d’un pilote non Plug-and-Play (PnP) a supprimé le service en mode noyau du pilote.

Syntaxe

ULONG WdfPostDeviceRemove(
  [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

WdfPostDeviceRemove 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 WdfPostDeviceRemove après que le programme d’installation a appelé DeleteService.

Pour obtenir l’adresse de la fonction WdfPostDeviceRemove 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 WdfPostDeviceRemove 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 WdfPostDeviceRemove , 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

WdfPreDeviceRemove

Partager via