WdfPostDeviceInstall, fonction (wdfinstaller.h)
[S’applique à KMDF uniquement]
La fonction WdfPostDeviceInstall du co-programme d’installation effectue toutes les opérations dont le co-programme d’installation peut avoir besoin une fois qu’un programme d’installation de pilote non Plug-and-Play (PnP) a créé le service en mode noyau du pilote.
Syntaxe
ULONG WdfPostDeviceInstall(
[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 la Microsoft Windows SDK.
[in, optional] InfSectionName
Pointeur vers une chaîne de caractères larges terminée par un caractère 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
WdfPostDeviceInstall 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 WdfPostDeviceInstall après que le programme d’installation a appelé CreateService.
Pour obtenir l’adresse de la fonction WdfPostDeviceInstall 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 WdfPostDeviceInstall 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 CreateService, GetProcAddress et LoadLibrary, consultez la documentation Microsoft Windows SDK.
Exemples
Pour obtenir un exemple de code qui utilise la fonction WdfPostDeviceInstall , 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.) |