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

Artículo
08/07/2023

El motor de filtros llama a la función de llamada FWPS_NET_BUFFER_LIST_NOTIFY_FN0 para notificar al controlador de llamada los eventos asociados a los paquetes etiquetados por la llamada.

NotaFWPS_NET_BUFFER_LIST_NOTIFY_FN0 es la versión específica de FWPS_NET_BUFFER_LIST_NOTIFY_FN usada en Windows 7 y versiones posteriores. Para obtener más información, vea NOMBRES DE Version-Independent DE PMA y versiones específicas de Windows dirigidas a destinatarios. Para Windows 8, FWPS_NET_BUFFER_LIST_NOTIFY_FN1 está disponible.

Sintaxis

FWPS_NET_BUFFER_LIST_NOTIFY_FN0 FwpsNetBufferListNotifyFn0;

void FwpsNetBufferListNotifyFn0(
  [in]                FWPS_NET_BUFFER_LIST_EVENT_TYPE0 eventType,
  [in, out, optional] NET_BUFFER_LIST *netBufferList,
  [in, out, optional] NET_BUFFER_LIST *newNetBufferList,
  [in]                UINT16 layerId,
  [in]                UINT64 context,
  [in]                UINT64 contextTag
)
{...}

Parámetros

[in] eventType

Valor que indica el tipo de notificación que el motor de filtros envía a la llamada. Este parámetro se establecerá en uno de los valores de . FWPS_NET_BUFFER_LIST_EVENT_TYPE0 enumeración.

[in, out, optional] netBufferList

Puntero a la lista de búferes que contiene paquetes etiquetados previamente como interesantes por el controlador de llamada.

[in, out, optional] newNetBufferList

Puntero a una lista de búferes actualizada que contiene paquetes interesantes para el controlador de llamada. El uso de este parámetro difiere en función del tipo de evento. En el caso de los eventos en los que se realiza un cambio en el paquete indicado, la versión modificada se pasa como este parámetro.

[in] layerId

Capa desde la que se llamó a la función de notificación.

[in] context

Contexto utilizado para etiquetar los paquetes de interés. Este valor es el valor asignado al paquete por el controlador de llamada y se usa para identificar el paquete.

[in] contextTag

Etiqueta de contexto usada para asociar los paquetes de interés con el contexto del controlador de llamada.

Valor devuelto

None

Observaciones

Esta función está asociada a un controlador de llamada mediante una llamada a FwpsNetBufferListAssociateContext0. Un controlador de llamada puede usar una única función de notificación para controlar los mensajes de varias listas de búferes asociadas mediante el contexto y la etiqueta de contexto para diferenciar entre instancias.

Requisitos

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