Fonction FltRegisterForDataScan (fltkernel.h)

Article
02/29/2024

La routine FltRegisterForDataScan permet l’analyse des données pour le volume attaché au minifiltre instance.

Syntaxe

NTSTATUS FLTAPI FltRegisterForDataScan(
  [in] PFLT_INSTANCE Instance
);

Paramètres

[in] Instance

Un pointeur de instance opaque pour le pilote de minifiltre instance de s’inscrire à l’analyse des données.

Valeur retournée

FltRegisterForDataScan retourne STATUS_SUCCESS ou une valeur NTSTATUS appropriée, comme l’une des valeurs suivantes.

Code de retour	Description
STATUS_NOT_SUPPORTED	Le gestionnaire de filtres ne prend pas en charge les analyses de données pour le volume attaché à cette instance.

Remarques

Un minifiltre qui effectue l’analyse des données doit inscrire son volume pour l’analyse en appelant FltRegisterForDataScan avant d’appeler FltCreateSectionForDataScan. Les minifiltres effectuent des analyses de données pour diverses raisons, telles que la détection de virus, le chiffrement ou la compression.

Notes

Si FltRegisterForDataScan retourne STATUS_NOT_SUPPORTED, un minifiltre peut toujours créer des sections pour l’analyse des données en appelant FsRtlCreateSectionForDataScan. Toutefois, l’accès à la section créée par FsRtlCreateSectionForDataScan n’est pas synchronisé et il incombe au minifiltre appelant de gérer toute résolution de conflit qui se produit. Ce minifiltre doit implémenter et inscrire une PFLT_SECTION_CONFLICT_NOTIFICATION_CALLBACK routine de rappel qui peut être appelée en cas de conflit de section.

Configuration requise

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