FWPS_INJECT_COMPLETE0 Rückruffunktion (fwpsk.h)

Artikel
02/26/2024

Die Filter-Engine ruft die Beschriftungsfunktion completionFn einer Legende auf, wenn Paketdaten, die durch den netBufferList-Parameter in einer der Paketeinschleusungsfunktionen beschrieben werden, in den Netzwerkstapel eingefügt wurden.

Syntax

FWPS_INJECT_COMPLETE0 FwpsInjectComplete0;

void FwpsInjectComplete0(
  [in]      void *context,
  [in, out] NET_BUFFER_LIST *netBufferList,
  [in]      BOOLEAN dispatchLevel
)
{...}

Parameter

[in] context

Ein Zeiger auf den completionContext-Parameter einer der Paketeinschleusungsfunktionen , die vom Legendentreiber aufgerufen werden.

[in, out] netBufferList

Der Zeiger, der im netBufferList-Parameter einer der vom Legendentreiber aufgerufenen Paketeinschleusungsfunktionen übergeben wird.

[in] dispatchLevel

Ein -Wert, der die IRQL angibt, an der die Calloutfunktion completionFn aufgerufen wird. Wenn dieser Parameter TRUE ist, wird die callout-Funktion completionFn unter IRQL = DISPATCH_LEVEL aufgerufen. Wenn dieser Parameter FALSE ist, wird die CompletionFn-Calloutfunktion an einem IRQL-DISPATCH_LEVEL < aufgerufen.

Rückgabewert

Keine

Bemerkungen

Der FWPS_INJECT_COMPLETE0 Typ wird wie folgt als Zeiger auf die funktion completionFn definiert:

typedef void (NTAPI *FWPS_INJECT_COMPLETE0) completionFn

Der Status-Member der NET_BUFFER_LIST Struktur, auf die von NetBufferList verwiesen wird, gibt das Ergebnis des Injektionsvorgangs an.

Nachdem Paketdaten in einer geklonten oder erstellten NET_BUFFER_LIST Strukturkette erfolgreich von einer der Paketeinschleusungsfunktionen in den Netzwerkstapel eingefügt wurden, wird completionFn aufgerufen.

Wenn die FwpsStreamInjectAsync0-Funktion aufgerufen wird, um eine Kette von NET_BUFFER_LIST-Strukturen einzuschleusen, wird completionFn einmal für jeden NET_BUFFER_LIST in der Kette aufgerufen, wobei jeweils derselbe completionContext-Parameter verwendet wird, der in FwpsStreamInjectAsync0 angegeben ist. In diesem Fall sollte die completionFn-Implementierung des Callout-Treibers FwpsFreeCloneNetBufferList0 aufrufen, um die aktuell angegebene NET_BUFFER_LIST freizusetzen.

Die Filter-Engine ruft die Beschriftungsfunktion completionFn einer Legende unter IRQL <= DISPATCH_LEVEL auf.

Anforderungen

Anforderung	Wert
Unterstützte Mindestversion (Client)	Verfügbar ab Windows Vista.
Zielplattform	Windows
Kopfzeile	fwpsk.h (include Fwpsk.h)
IRQL	<= DISPATCH_LEVEL