FltGetFilterInformation-Funktion (fltkernel.h)

Artikel
02/06/2025

Die FltGetFilterInformation Routine stellt Informationen zu einem Minifiltertreiber bereit.

Syntax

NTSTATUS FLTAPI FltGetFilterInformation(
  [in]  PFLT_FILTER              Filter,
  [in]  FILTER_INFORMATION_CLASS InformationClass,
  [out] PVOID                    Buffer,
  [in]  ULONG                    BufferSize,
  [out] PULONG                   BytesReturned
);

Parameter

[in] Filter

Undurchsichtiger Filterzeiger für den Aufrufer.

[in] InformationClass

Typ der angeforderten Informationen. Dieser Parameter kann einen der folgenden Werte aufweisen.

Wert	Bedeutung
FilterFullInformation-	Der Puffer, auf den der parameter Buffer verweist, empfängt eine FILTER_FULL_INFORMATION Struktur für den Minifiltertreiber.
FilterAggregateBasicInformation	Der puffer, auf den der parameter Buffer verweist, empfängt eine FILTER_AGGREGATE_BASIC_INFORMATION Struktur für den Minifiltertreiber. Dieser InformationClass--Wert ist ab Microsoft Windows Server 2003 SP1 und Windows XP SP2 mit Filter-Manager-Rollup verfügbar. Weitere Informationen zum Rolluppaket des Filter-Managers für Windows XP SP2 finden Sie im Artikel 914882 " Das Filter-Manager-Rolluppaket für Windows XP SP2"" in der Microsoft Knowledge Base.
FilterAggregateStandardInformation	Der Puffer, auf den der parameter Buffer verweist, empfängt eine FILTER_AGGREGATE_STANDARD_INFORMATION Struktur für den Minifiltertreiber. Der LegacyFilter- Teil der Struktur wird nicht verwendet. Dieser InformationClass--Wert ist ab Windows Vista verfügbar.

[out] Buffer

Zeigen Sie auf einen vom Aufrufer zugewiesenen Puffer, der die angeforderten Informationen empfängt. Der Typ der im Puffer zurückgegebenen Informationen wird durch den parameter InformationClass definiert.

[in] BufferSize

Größe des Puffers, auf den der Buffer Parameter verweist, in Byte. Der Aufrufer sollte diesen Parameter gemäß dem angegebenen InformationClass-wert festlegen.

[out] BytesReturned

Zeiger auf eine vom Aufrufer zugewiesene Variable, die die Anzahl der im Puffer zurückgegebenen Bytes empfängt, auf die Buffer verweist. Wenn der Eingabewert von BufferSize zu klein ist, gibt FltGetFilterInformation STATUS_BUFFER_TOO_SMALL zurück und legt diese Variable auf die Anzahl der Bytes fest, die zum Speichern der angeforderten Informationen erforderlich sind. Dieser Parameter ist erforderlich und kann nicht NULL-werden.

Rückgabewert

FltGetFilterInformation gibt STATUS_SUCCESS oder einen geeigneten NTSTATUS-Wert zurück, z. B. einen der folgenden:

Rückgabecode	Beschreibung
STATUS_BUFFER_TOO_SMALL	Der Puffer, auf den der Buffer Parameter verweist, ist nicht groß genug, um die angeforderten Informationen zu speichern. Dies ist ein Fehlercode.
STATUS_INVALID_PARAMETER	Für den parameter InformationClass wurde ein ungültiger Wert angegeben. Wenn beispielsweise FilterAggregateStandardInformation auf einem Betriebssystem vor Windows Vista angegeben wird, gibt die Routine STATUS_INVALID_PARAMETER zurück. Dies ist ein Fehlercode.