FltRegisterForDataScan-Funktion (fltkernel.h)

Die FltRegisterForDataScan-Routine ermöglicht die Datenüberprüfung für das Volume, das an den Minifilter instance angefügt ist.

Syntax

NTSTATUS FLTAPI FltRegisterForDataScan(
  [in] PFLT_INSTANCE Instance
);

Parameter

[in] Instance

Ein undurchsichtiger instance-Zeiger für den Minifiltertreiber instance, um sich für die Datenüberprüfung zu registrieren.

Rückgabewert

FltRegisterForDataScan gibt STATUS_SUCCESS oder einen entsprechenden NTSTATUS-Wert zurück, z. B. einen der folgenden.

Rückgabecode	Beschreibung
STATUS_NOT_SUPPORTED	Der Filter-Manager unterstützt keine Datenüberprüfungen für das Volume, das diesem instance angefügt ist.

Hinweise

Ein Minifilter, der die Datenüberprüfung durchführt, muss sein Volume für die Überprüfung registrieren, indem er FltRegisterForDataScanaufruft, bevor FltCreateSectionForDataScan aufgerufen wird. Minifilter führen Datenüberprüfungen aus verschiedenen Gründen durch, z. B. Virenerkennung, Verschlüsselung oder Komprimierung.

Hinweis

Wenn FltRegisterForDataScan STATUS_NOT_SUPPORTED zurückgibt, kann ein Minifilter weiterhin Abschnitte für die Datenüberprüfung erstellen, indem FsRtlCreateSectionForDataScan aufgerufen wird. Der Zugriff auf den von FsRtlCreateSectionForDataScan erstellten Abschnitt wird jedoch nicht synchronisiert, und es liegt in der Verantwortung des aufrufenden Minifilters, alle auftretenden Konfliktlösungen zu behandeln. Ein solcher Minifilter muss eine PFLT_SECTION_CONFLICT_NOTIFICATION_CALLBACK Rückrufroutine implementieren und registrieren, die aufgerufen werden kann, wenn ein Abschnittskonflikt auftritt.

Anforderungen

Anforderung	Wert
Unterstützte Mindestversion (Client)	Windows 8
Zielplattform	Universell
Header	fltkernel.h (include Fltkernel.h)
Bibliothek	FltMgr.lib
DLL	Fltmgr.sys
IRQL	<= APC_LEVEL

Weitere Informationen

FltAllocateContext

FltCloseSectionForDataScan

FltCreateSectionForDataScan

FsRtlCreateSectionForDataScan

PFLT_SECTION_CONFLICT_NOTIFICATION_CALLBACK