Partager via


PFLT_SECTION_CONFLICT_NOTIFICATION_CALLBACK fonction de rappel (fltkernel.h)

Un pilote de minifiltre peut éventuellement inscrire une routine de type PFLT_SECTION_CONFLICT_NOTIFICATION_CALLBACK comme routine SectionNotificationCallback du pilote minifiltre. Certaines opérations de fichier ne sont pas compatibles avec les sections de fichier. Si un minifiltre fournit une routine SectionNotificationCallback , le rappel est appelé lorsque des conflits de section se produisent.

Syntaxe

PFLT_SECTION_CONFLICT_NOTIFICATION_CALLBACK PfltSectionConflictNotificationCallback;

NTSTATUS PfltSectionConflictNotificationCallback(
  [in] PFLT_INSTANCE Instance,
  [in] PFLT_CONTEXT SectionContext,
  [in] PFLT_CALLBACK_DATA Data
)
{...}

Paramètres

[in] Instance

Un pointeur de instance opaque vers le pilote de minifiltre instance qui lance l’opération d’E/S.

[in] SectionContext

Pointeur vers le contexte de section qui a entraîné un conflit de section d’analyse des données.

[in] Data

Pointeur vers une structure allouée à l’appelant qui contient les données de rappel.

Valeur retournée

Cette routine de rappel retourne STATUS_SUCCESS.

Remarques

Un minifiltre s’inscrit pour les notifications de conflit de section en définissant une PFLT_SECTION_CONFLICT_NOTIFICATION_CALLBACK routine sur le membre SectionNotificationCallback de la structure FLT_REGISTRATION lors de l’inscription d’un pilote de minifiltre.

Certaines situations peuvent se produire lorsque le maintien d’une section ouverte est incompatible avec les E/S de fichier actuelles. En particulier, les E/S de fichier qui déclenchent une purge du cache peuvent entraîner une incohérence du cache si la purge du cache est empêchée en raison d’une section ouverte. Un minifiltre peut fournir cette routine de rappel facultative pour les notifications de ces événements. Lorsqu’une notification est reçue, la section peut être fermée pour permettre à l’opération d’E/S en conflit de continuer.

Configuration requise

Condition requise Valeur
Client minimal pris en charge La routine de rappel PFLT_CONTEXT_ALLOCATE_CALLBACK est disponible sur Windows 8 et versions ultérieures.
Plateforme cible Desktop (Expérience utilisateur)
En-tête fltkernel.h (inclure Fltkernel.h)
IRQL PASSIVE_LEVEL

Voir aussi

FLT_CALLBACK_DATA

FLT_REGISTRATION

FltCreateSectionForDataScan

FltRegisterFilter