FltStartFiltering-Funktion (fltkernel.h)

  • Artikel

FltStartFiltering beginnt mit der Filterung nach einem registrierten Minifiltertreiber.

Syntax

NTSTATUS FLTAPI FltStartFiltering(
  [in] PFLT_FILTER Filter
);

Parameter

[in] Filter

Undurchsichtiger Filterzeiger, der von FltRegisterFilter zurückgegeben wird.

Rückgabewert

FltStartFiltering gibt STATUS_SUCCESS oder einen entsprechenden NTSTATUS-Wert wie den folgenden zurück:

Rückgabecode Beschreibung
STATUS_INVALID_PARAMETER
 Die Filterung für diesen Minifiltertreiber wurde bereits gestartet. Dies ist ein Fehlercode.

Hinweise

Ein Minifiltertreiber ruft In der Regel FltStartFiltering aus seiner DriverEntry-Routine auf, nachdem er die globale Initialisierung abgeschlossen und FltRegisterFilter aufgerufen 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 voll aktiven Minifiltertreiber und stellt ihn mit Volumes zum Anfügen sowie E/A-Anforderungen vor. Der Minifiltertreiber muss bereit sein, diese Benachrichtigungen und E/A-Anforderungen zu empfangen, noch bevor FltStartFiltering zurückgegeben wird.

Anforderungen

Anforderung Wert
Zielplattform Universell
Header fltkernel.h (include Fltkernel.h)
Bibliothek FltMgr.lib
DLL Fltmgr.sys
IRQL <= APC_LEVEL

Weitere Informationen

FltRegisterFilter