Compartir a través de

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. Consulta nombres Version-Independent DEL PMA y destinatarios de versiones específicas de Windows para obtener más información. 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 envía el motor de filtros 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 que son 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 usado 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
 Error.

Observaciones

Esta función está asociada a un controlador de llamada mediante una llamada a FwpsNetBufferListAssociateContext1. Un controlador de llamada puede usar una sola función de notificación para controlar los mensajes de varias listas de búfer 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 Valor
cliente mínimo admitido Disponible a partir de Windows 8.
de la plataforma de destino de Windows
encabezado de fwpsk.h (incluya Fwpsk.h)
irQL <= DISPATCH_LEVEL

Consulte también

funciones de llamada del controlador de llamada de

FWPS_NET_BUFFER_LIST_EVENT_TYPE0

FWPS_NET_BUFFER_LIST_NOTIFY_FN0

fwpsNetBufferListAssociateContext1

usar de etiquetado de paquetes