Remarque
L’accès à cette page nécessite une autorisation. Vous pouvez essayer de vous connecter ou de modifier des répertoires.
L’accès à cette page nécessite une autorisation. Vous pouvez essayer de modifier des répertoires.
La fonction FilterLoad charge dynamiquement un pilote minifilter dans le système.
Syntaxe
HRESULT FilterLoad(
[in] LPCWSTR lpFilterName
);
Paramètres
[in] lpFilterName
Pointeur vers une chaîne de caractères larges terminée par null qui spécifie le nom du service du pilote minifilter. Ce paramètre est obligatoire et ne peut pas être NULL ou une chaîne vide.
Valeur retournée
FilterLoad retourne S_OK en cas de réussite. Sinon, elle retourne l’une des valeurs d’erreur suivantes :
| Code de retour | Descriptif |
|---|---|
|
Le pilote minifilter est déjà en cours d’exécution. |
|
Aucun pilote minifilter correspondant n’a été trouvé. |
|
Le pilote minifilter est déjà en cours d’exécution. |
|
L’image de chargement du pilote minifilter spécifié par lpFilterName n’est pas valide. |
|
L’image de chargement du pilote minifilter spécifié par lpFilterName n’est pas valide. |
|
Le pilote minifilter a une signature numérique non valide. |
Remarques
FilterLoad est l’équivalent Win32 de FltLoadFilter.
Une application en mode utilisateur qui a une dépendance sur un pilote minifilter en mode noyau peut charger le pilote minifilter en appelant FilterLoad.
Les appelants de FilterLoad doivent avoir SeLoadDriverPrivilege (lui-même de SE_LOAD_DRIVER_PRIVILEGE) pour charger ou décharger un pilote minifilter. Ce privilège est nommé par la constante de nom SE_LOAD_DRIVER_NAME. (Les privilèges sont décrits dans la documentation du Kit de développement logiciel (SDK) Microsoft Windows pour Windows 7 et .NET Framework 4.0.)
Pour décharger le pilote minifilter, appelez FilterUnload.
Spécifications
| Requirement | Valeur |
|---|---|
| plateforme cible | Universal |
| Header | fltuser.h (include Fltuser.h) |
| Library | FltLib.lib |
| DLL | FltLib.dll |