Freigeben über


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
STATUS_INVALID_PARAMETER
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

Siehe auch

FltRegisterFilter-