Fonction WdfPreDeviceInstall (wdfinstaller.h)

Article
08/08/2023

[S’applique uniquement à KMDF]

La fonction WdfPreDeviceInstall 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) crée le service en mode noyau du pilote.

Syntaxe

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

WdfPreDeviceInstall 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 WdfPreDeviceInstall ou WdfPreDeviceInstallEx avant que le programme d’installation appelle CreateService.

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

Si le co-programme d’installation détermine que l’ordinateur doit être redémarré pour terminer l’installation du pilote (généralement parce qu’une version antérieure de l’infrastructure a été installée), WdfPreDeviceInstall informe le gestionnaire de Plug-and-Play (PnP). Le gestionnaire PnP demande ensuite à l’utilisateur qu’un redémarrage est nécessaire.

Pour plus d’informations sur la fonction WdfPreDeviceInstall 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 WdfPreDeviceInstall , 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

WdfPostDeviceInstall

Partager via