FltStartFiltering-Funktion (fltkernel.h)
FltStartFiltering beginnt mit dem Filtern nach einem registrierten Minifiltertreiber.
Syntax
NTSTATUS FLTAPI FltStartFiltering(
[in] PFLT_FILTER Filter
);
Parameter
[in] Filter
Undurchsichtiger Filterzeiger, der von FltRegisterFilterzurückgegeben wird.
Rückgabewert
FltStartFiltering gibt STATUS_SUCCESS oder einen geeigneten NTSTATUS-Wert wie den folgenden zurück:
Rückgabecode | Beschreibung |
---|---|
|
Die Filterung wurde bereits für diesen Minifiltertreiber gestartet. Dies ist ein Fehlercode. |
Bemerkungen
Ein Minifiltertreiber ruft in der Regel FltStartFiltering aus seiner DriverEntry Routine auf, nachdem sie die globale Initialisierung abgeschlossen und FltRegisterFilteraufgerufen hat. FltStartFiltering benachrichtigt den Filter-Manager, dass der Minifiltertreiber bereit ist, mit dem Anfügen an Volumes und Filtern von E/A-Anforderungen zu beginnen. Nachdem der Minifiltertreiber diese Routine aufgerufen hat, behandelt der Filter-Manager den Minifiltertreiber als vollständig aktiven Minifiltertreiber und stellt ihn mit Volumes zur Verbindung sowie E/A-Anforderungen dar. Der Minifiltertreiber muss darauf vorbereitet sein, diese Benachrichtigungen und E/A-Anforderungen zu empfangen, auch bevor FltStartFiltering zurückgibt.
Anforderungen
Anforderung | Wert |
---|---|
Zielplattform- | Universal |
Header- | fltkernel.h (include Fltkernel.h) |
Library | FltMgr.lib |
DLL- | Fltmgr.sys |
IRQL- | <= APC_LEVEL |