FWPS_INJECT_COMPLETE0 Rückruffunktion (fwpsk.h)
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 |