FltStartFiltering, fonction (fltkernel.h)
FltStartFiltering commence à filtrer pour un pilote minifilter inscrit.
Syntaxe
NTSTATUS FLTAPI FltStartFiltering(
[in] PFLT_FILTER Filter
);
Paramètres
[in] Filter
Pointeur de filtre opaque retourné par FltRegisterFilter.
Valeur de retour
fltStartFiltering retourne STATUS_SUCCESS ou une valeur NTSTATUS appropriée, par exemple :
Retourner le code | Description |
---|---|
|
Le filtrage a déjà été démarré pour ce pilote minifilter. Il s’agit d’un code d’erreur. |
Remarques
Un pilote minifilter appelle généralement FltStartFiltering à partir de sa routine DriverEntry une fois son initialisation globale terminée et appelée FltRegisterFilter. FltStartFiltering avertit le Gestionnaire de filtres que le pilote minifilter est prêt à commencer à attacher des volumes et à filtrer les demandes d’E/S. Une fois que le pilote minifilter appelle cette routine, le Gestionnaire de filtre traite le pilote minifilter comme un pilote minifilter entièrement actif, le présentant avec des volumes à attacher, ainsi que des requêtes d’E/S. Le pilote minifilter doit être prêt à commencer à recevoir ces notifications et demandes d’E/S avant même que FltStartFiltering retourne.
Exigences
Exigence | Valeur |
---|---|
plateforme cible | Universel |
d’en-tête | fltkernel.h (include Fltkernel.h) |
bibliothèque | FltMgr.lib |
DLL | Fltmgr.sys |
IRQL | <= APC_LEVEL |