PFLT_SECTION_CONFLICT_NOTIFICATION_CALLBACK fonction de rappel (fltkernel.h)
Un pilote minifilter peut éventuellement inscrire une routine de type PFLT_SECTION_CONFLICT_NOTIFICATION_CALLBACK en tant que routine SectionNotificationCallback du pilote minifilter. Certaines opérations de fichier ne sont pas compatibles avec les sections de fichier. Si un minifilter 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
Pointeur d’instance opaque vers l’instance de pilote minifilter 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 par l’appelant qui contient les données de rappel.
Valeur de retour
Cette routine de rappel retourne STATUS_SUCCESS.
Remarques
Un minifilter s’inscrit pour les notifications de conflit de section en définissant une routine de PFLT_SECTION_CONFLICT_NOTIFICATION_CALLBACK sur la SectionNotificationCallback membre de la structure FLT_REGISTRATION lors de l’inscription d’un pilote minifilter.
Certaines situations peuvent se produire lorsque la conservation d’une section ouverte n’est pas compatible 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 le vidage du cache est empêché en raison d’une section ouverte. Un minifilter 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.
Exigences
| Exigence | Valeur |
|---|---|
| client minimum pris en charge | La routine de rappel PFLT_CONTEXT_ALLOCATE_CALLBACK est disponible sur Windows 8 et versions ultérieures. |
| plateforme cible | Bureau |
| d’en-tête | fltkernel.h (include Fltkernel.h) |
| IRQL | PASSIVE_LEVEL |