Fonction FilterLoad (fltuser.h)

Article
08/23/2023

La fonction FilterLoad charge dynamiquement un pilote de minifiltre 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 de service du pilote de minifiltre. 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, il retourne l’une des valeurs d’erreur suivantes :

Code de retour	Description
HRESULT_FROM_WIN32 (ERROR_ALREADY_EXISTS)	Le pilote de minifiltre est déjà en cours d’exécution.
HRESULT_FROM_WIN32 (ERROR_FILE_NOT_FOUND)	Aucun pilote de minifiltre correspondant n’a été trouvé.
HRESULT_FROM_WIN32 (ERROR_SERVICE_ALREADY_RUNNING)	Le pilote de minifiltre est déjà en cours d’exécution.
HRESULT_FROM_WIN32 (ERROR_BAD_EXE_FORMAT)	L’image de chargement du pilote minifilter spécifié par lpFilterName n’est pas valide.
HRESULT_FROM_WIN32 (ERROR_BAD_DRIVER)	L’image de chargement du pilote minifilter spécifié par lpFilterName n’est pas valide.
HRESULT_FROM_WIN32 (ERROR_INVALID_IMAGE_HASH)	Le pilote de minifiltre a une signature numérique non valide.

Notes

FilterLoad est l’équivalent Win32 de FltLoadFilter.

Une application en mode utilisateur qui a une dépendance sur un pilote de minifiltre en mode noyau peut charger le pilote de minifiltre en appelant FilterLoad.

Les appelants de FilterLoad doivent disposer de SeLoadDriverPrivilege (lui-même de SE_LOAD_DRIVER_PRIVILEGE) pour charger ou décharger un pilote de minifiltre. 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 de minifiltre, appelez FilterUnload.