FWPS_INJECT_COMPLETE0 funzione di callback (fwpsk.h)

Articolo
03/08/2023

Il motore di filtro chiama la funzione callout completionFn di un callout ogni volta che i dati dei pacchetti, descritti dal parametro netBufferList in una delle funzioni di inserimento dei pacchetti, sono stati inseriti nello stack di rete.

Sintassi

FWPS_INJECT_COMPLETE0 FwpsInjectComplete0;

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

Parametri

[in] context

Puntatore al parametro completionContext di una delle funzioni di inserimento di pacchetti chiamate dal driver del callout.

[in, out] netBufferList

Puntatore passato nel parametro netBufferList di una delle funzioni di inserimento dei pacchetti chiamate dal driver del callout.

[in] dispatchLevel

Valore che indica l'IRQL in corrispondenza del quale viene chiamata la funzione callout completionFn . Se questo parametro è TRUE, la funzione callout completionFn viene chiamata in IRQL = DISPATCH_LEVEL. Se questo parametro è FALSE, la funzione callout completionFn viene chiamata in un DISPATCH_LEVEL IRQL < .

Valore restituito

nessuno

Osservazioni

Il tipo FWPS_INJECT_COMPLETE0 è definito come puntatore alla funzione completionFn come segue:

typedef void (NTAPI *FWPS_INJECT_COMPLETE0) completionFn

Il membro Status della struttura NET_BUFFER_LIST a cui punta NetBufferList indica il risultato dell'operazione di inserimento.

Dopo che i dati dei pacchetti in una catena di strutture clonata o creata NET_BUFFER_LIST sono stati inseriti correttamente nello stack di rete da una delle funzioni di inserimento di pacchetti, viene chiamato completionFn .

Se la funzione FwpsStreamInjectAsync0 viene chiamata per inserire una catena di strutture NET_BUFFER_LIST , completionFn verrà chiamato una volta per ogni NET_BUFFER_LIST nella catena, ogni volta che si usa lo stesso parametro completionContext specificato in FwpsStreamInjectAsync0. In questo caso, l'implementazione completionFn del driver callout deve chiamare FwpsFreeCloneNetBufferList0 per liberare il NET_BUFFER_LIST indicato.

Il motore di filtro chiama la funzione callout completionFn di un callout in IRQL <= DISPATCH_LEVEL.

Requisiti

Requisito	Valore
Client minimo supportato	Disponibile a partire da Windows Vista.
Piattaforma di destinazione	Windows
Intestazione	fwpsk.h (include Fwpsk.h)
IRQL	<= DISPATCH_LEVEL