FWPS_CALLOUT_CLASSIFY_FN2 Rückruffunktion (fwpsk.h)

Artikel
02/07/2025

Das Filtermodul ruft die klassifizierenFn2 Legendenfunktion eines Popups auf, wenn daten vorhanden sind, die von der Legende verarbeitet werden sollen.

HinweisklassifizierenFn2 ist die spezifische Version von klassifizierenFn in Windows 8 und höher verwendet. Weitere Informationen finden Sie unter WFP-Version-Independent Namen und zielspezifische Versionen von Windows. Für Windows 7 ist klassifizierenFn1 verfügbar. Für Windows Vista ist klassifizierenFn0 verfügbar.

Syntax

FWPS_CALLOUT_CLASSIFY_FN2 FwpsCalloutClassifyFn2;

void FwpsCalloutClassifyFn2(
  [in]                const FWPS_INCOMING_VALUES0 *inFixedValues,
  [in]                const FWPS_INCOMING_METADATA_VALUES0 *inMetaValues,
  [in, out, optional] void *layerData,
  [in, optional]      const void *classifyContext,
  [in]                const FWPS_FILTER2 *filter,
  [in]                UINT64 flowContext,
  [in, out]           FWPS_CLASSIFY_OUT0 *classifyOut
)
{...}

Parameter

[in] inFixedValues

Ein Zeiger auf eine FWPS_INCOMING_VALUES0 Struktur. Diese Struktur enthält die Werte für die einzelnen Datenfelder in der gefilterten Ebene.

[in] inMetaValues

Ein Zeiger auf einen FWPS_INCOMING_METADATA_VALUES0 Struktur. Diese Struktur enthält die Werte für jedes metadatenfeld in der gefilterten Ebene.

[in, out, optional] layerData

Ein Zeiger auf eine Struktur, die die Rohdaten in der gefilterten Ebene beschreibt. Dieser Parameter kann NULL sein, abhängig von der gefilterten Ebene und den Bedingungen, unter denen die klassifizierenFn2 Popupfunktion aufgerufen wird. Für die Datenstromebene verweist dieser Parameter auf eine FWPS_STREAM_CALLOUT_IO_PACKET0 Struktur. Für alle anderen Ebenen verweist dieser Parameter auf eine NET_BUFFER_LIST Struktur, wenn er nicht NULL ist.

[in, optional] classifyContext

Ein Zeiger auf Kontextdaten, die dem Legendentreiber durch das Filtermodul zugeordnet sind.

[in] filter

Ein Zeiger auf eine FWPS_FILTER2 Struktur. Diese Struktur beschreibt den Filter, der die Legende für die Aktion des Filters angibt.

[in] flowContext

Eine UINT64-typierte Variable, die den Kontext enthält, der dem Datenfluss zugeordnet ist. Wenn dem Datenfluss kein Kontext zugeordnet ist, ist dieser Parameter null. Wenn die Legende dem Filtermodul auf einer Filterebene hinzugefügt wird, die keine Datenflüsse unterstützt, sollte die klassifizierenFn2 Legendenfunktion diesen Parameter ignorieren.

[in, out] classifyOut

Ein Zeiger auf eine FWPS_CLASSIFY_OUT0 Struktur, die Daten empfängt, die die klassifizierenFn2 Popupfunktion an den Aufrufer zurückgibt.

Rückgabewert

Nichts

Bemerkungen

Ein Legendentreiber registriert die Legendenfunktionen einer Legende mit dem Filtermodul, indem die FwpsCalloutRegister2-Funktion aufgerufen wird.

Das Filtermodul ruft die klassifizierenFn2 Legendenfunktion mit Daten auf, die verarbeitet werden sollen, wenn alle Testbedingungen für einen Filter im Filtermodul gelten, der die Legende für die Aktion des Filters angibt.

Die klassifizierenFn2 Legendenfunktion einer Legende sollte die FWPS_RIGHT_ACTION_WRITE Kennzeichnung im Rechte Mitglied der FWPS_CLASSIFY_OUT0 Struktur in einem der folgenden Situationen löschen:

Wenn die klassifizierenFn2 Legendenfunktion das actionType Member der FWPS_CLASSIFY_OUT0 Struktur auf FWP_ACTION_BLOCK festlegt.
Wenn die klassifizierenFn2 Legendenfunktion das actionType Member der FWPS_CLASSIFY_OUT0 Struktur auf FWP_ACTION_PERMIT und das FWPS_FILTER_FLAG_CLEAR_ACTION_RIGHT Flag im Flags Member der FWPS_FILTER2 Struktur festgelegt wird.
Wenn eine Legende angegeben hat, dass sie beabsichtigt, die Klonnetzpufferliste zu ändern, indem sie die intendToModify Parameter in einem Aufruf des Aufrufs auf TRUE festlegen FwpsReferenceNetBufferList0 Funktion.
Diese Funktion ist im Wesentlichen identisch mit der vorherigen Version, klassifizierenFn1. Die aktualisierte FWPS_FILTER2-Struktur wird jedoch durch den Filterparameter-Parameter verwiesen, und der layerData--Parameter ist optional.