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

  • Artículo

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

Nota FWPS_NET_BUFFER_LIST_NOTIFY_FN1 es la versión específica de FWPS_NET_BUFFER_LIST_NOTIFY_FN usada en Windows 8 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 7, FWPS_NET_BUFFER_LIST_NOTIFY_FN0 está disponible.

 

Sintaxis

FWPS_NET_BUFFER_LIST_NOTIFY_FN1 FwpsNetBufferListNotifyFn1;

NTSTATUS FwpsNetBufferListNotifyFn1(
  [in]                FWPS_NET_BUFFER_LIST_EVENT_TYPE0 eventType,
  [in, out]           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] 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

Una llamada FWPS_NET_BUFFER_LIST_NOTIFY_FN1 función devuelve uno de los siguientes códigos NTSTATUS.

Código devuelto Descripción
STATUS_SUCCESS
 El controlador de llamada acepta la notificación del motor de filtro.
Otros códigos de estado
 Se produjo un error.

Comentarios

Esta función está asociada a un controlador de llamada mediante una llamada a FwpsNetBufferListAssociateContext1. 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.

Esta función es idéntica a FWPS_NET_BUFFER_LIST_NOTIFY_FN0, salvo que el tipo de valor devuelto es NTSTATUS en lugar de VOID.

Requisitos

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

Consulte también

Funciones de llamada del controlador de llamada

FWPS_NET_BUFFER_LIST_EVENT_TYPE0

FWPS_NET_BUFFER_LIST_NOTIFY_FN0

FwpsNetBufferListAssociateContext1

Uso del etiquetado de paquetes