Partager via

Écriture d’une routine DriverEntry pour un pilote Minifilter

  • Article

Chaque pilote de minifiltre de système de fichiers doit avoir une routine DriverEntry . La routine DriverEntry est appelée lorsque le pilote minifilter est chargé.

La routine DriverEntry effectue une initialisation globale, inscrit le pilote minifilter et lance le filtrage. Cette routine s’exécute dans un contexte de thread système au PASSIVE_LEVEL IRQL.

La routine DriverEntry est définie comme suit :

NTSTATUS 
(*PDRIVER_INITIALIZE) ( 
    IN PDRIVER_OBJECT DriverObject, 
    IN PUNICODE_STRING RegistryPath 
    );

DriverEntry a deux paramètres d’entrée. Le premier, DriverObject, est l’objet pilote qui a été créé lors du chargement du pilote minifilter. Le deuxième, RegistryPath, est un pointeur vers une chaîne Unicode comptée qui contient un chemin d’accès à la clé de Registre du pilote minifilter.

La routine DriverEntry d’un pilote minifilter doit effectuer les étapes suivantes, dans l’ordre :

  1. Effectuez toute initialisation globale nécessaire pour le pilote minifilter.

  2. Inscrivez le pilote minifilter en appelant FltRegisterFilter.

  3. Lancez le filtrage en appelant FltStartFiltering.

  4. Retourne une valeur NTSTATUS appropriée.

Cette section comprend :

Inscription du pilote Minifilter

Lancement du filtrage

Retour de l’état à partir d’une routine DriverEntry Minifilter