Fonction FltRegisterForDataScan (fltkernel.h)
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 |