FltGetFilterInformation-Funktion (fltkernel.h)

Artikel
08/07/2023

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 Buffer-Parameter verweist, empfängt eine FILTER_FULL_INFORMATION-Struktur für den Minifiltertreiber.
FilterAggregateBasicInformation	Der Puffer, auf den der Buffer-Parameter 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 Filter-Manager-Rolluppaket für Windows XP SP2 finden Sie in der Microsoft Knowledge Base im Artikel 914882 " Das Filter-Manager-Rolluppaket für Windows XP SP2".
FilterAggregateStandardInformation	Der Puffer, auf den der Buffer-Parameter 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

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

[in] BufferSize

Größe des Puffers in Byte, auf den der Buffer-Parameter zeigt. Der Aufrufer sollte diesen Parameter entsprechend dem angegebenen InformationClass-Wert festlegen.

[out] BytesReturned

Zeiger auf eine vom Aufrufer zugeordnete Variable, die die Anzahl der Bytes empfängt, die im Puffer zurückgegeben werden, auf den 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 von Bytes fest, die zum Speichern der angeforderten Informationen erforderlich sind. Dieser Parameter ist erforderlich und darf nicht NULL sein.

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 InformationClass-Parameter wurde ein ungültiger Wert angegeben. Wenn beispielsweise FilterAggregateStandardInformation auf einem Betriebssystem vor Windows Vista angegeben ist, gibt die Routine STATUS_INVALID_PARAMETER zurück. Dies ist ein Fehlercode.