Fonction FltStartFiltering (fltkernel.h)

FltStartFiltering commence à filtrer pour un pilote de minifiltre inscrit.

Syntaxe

NTSTATUS FLTAPI FltStartFiltering(
  [in] PFLT_FILTER Filter
);

Paramètres

[in] Filter

Pointeur de filtre opaque retourné par FltRegisterFilter.

Valeur retournée

FltStartFiltering retourne STATUS_SUCCESS ou une valeur NTSTATUS appropriée, telle que :

Code de retour Description
STATUS_INVALID_PARAMETER
Le filtrage a déjà été démarré pour ce pilote de minifiltre. Il s’agit d’un code d’erreur.

Remarques

Un pilote de minifiltre appelle généralement FltStartFiltering à partir de sa routine DriverEntry une fois son initialisation globale terminée et appelée FltRegisterFilter. FltStartFiltering informe le Gestionnaire de filtres que le pilote de minifiltre est prêt à commencer à attacher aux volumes et à filtrer les demandes d’E/S. Une fois que le pilote de minifiltre appelle cette routine, le Gestionnaire de filtres traite le pilote de minifiltre comme un pilote de minifiltre entièrement actif, lui présentant des volumes à attacher, ainsi que des demandes d’E/S. Le pilote de minifiltre doit être prêt à commencer à recevoir ces notifications et demandes d’E/S avant même que FltStartFiltering ne retourne.

Configuration requise

Condition requise Valeur
Plateforme cible Universal
En-tête fltkernel.h (inclure Fltkernel.h)
Bibliothèque FltMgr.lib
DLL Fltmgr.sys
IRQL <= APC_LEVEL

Voir aussi

FltRegisterFilter