FWPS_INJECT_COMPLETE0 función de devolución de llamada (fwpsk.h)

Artículo
02/26/2024

El motor de filtro llama a la función de llamada completionFn callout cada vez que los datos de paquetes, descritos por el parámetro netBufferList en una de las funciones de inserción de paquetes, se han insertado en la pila de red.

Sintaxis

FWPS_INJECT_COMPLETE0 FwpsInjectComplete0;

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

Parámetros

[in] context

Puntero al parámetro completionContext de una de las funciones de inserción de paquetes a las que llama el controlador de llamada.

[in, out] netBufferList

Puntero pasado en el parámetro netBufferList de una de las funciones de inserción de paquetes a las que llama el controlador de llamada.

[in] dispatchLevel

Valor que indica el IRQL en el que se llama a la función de llamada completionFn . Si este parámetro es TRUE, se llama a la función de llamada completionFn en IRQL = DISPATCH_LEVEL. Si este parámetro es FALSE, se llama a la función de llamada completionFn en una DISPATCH_LEVEL IRQL < .

Valor devuelto

None

Observaciones

El tipo FWPS_INJECT_COMPLETE0 se define como puntero a la función completionFn de la siguiente manera:

typedef void (NTAPI *FWPS_INJECT_COMPLETE0) completionFn

El miembro Status de la estructura NET_BUFFER_LIST a la que apunta NetBufferList indica el resultado de la operación de inyección.

Después de que uno de los datos de paquete de una cadena de estructura clonada o creada NET_BUFFER_LIST se haya insertado correctamente en la pila de red mediante una de las funciones de inyección de paquetes, se llama a completionFn .

Si se llama a la función FwpsStreamInjectAsync0 para insertar una cadena de estructuras de NET_BUFFER_LIST , se llamará a completionFn una vez por cada NET_BUFFER_LIST de la cadena, cada vez que use el mismo parámetro completionContext especificado en FwpsStreamInjectAsync0. En este caso, la implementación del controlador de llamadaFn debe llamar a FwpsFreeCloneNetBufferList0 para liberar los NET_BUFFER_LIST indicados actualmente.

El motor de filtros llama a la función de llamada completionFn callout en IRQL <= DISPATCH_LEVEL.

Requisitos

Requisito	Value
Cliente mínimo compatible	Disponible a partir de Windows Vista.
Plataforma de destino	Windows
Encabezado	fwpsk.h (incluya Fwpsk.h)
IRQL	<= DISPATCH_LEVEL