Función FwpsNetBufferListAssociateContext1 (fwpsk.h)

La función FwpsNetBufferListAssociateContext1 asocia el contexto del controlador de llamada a una lista de búferes de red y configura la notificación para eventos de lista de búferes de red.

NotaFwpsNetBufferListAssociateContext1 es la versión específica de FwpsNetBufferListAssociateContext usada en Windows 8 y versiones posteriores. Para obtener más información, consulte NOMBRES de PMA Version-Independent y versiones específicas de destino de Windows . Para Windows 7, FwpsNetBufferListAssociateContext0 está disponible.

 

Sintaxis

NTSTATUS FwpsNetBufferListAssociateContext1(
  [in, out] NET_BUFFER_LIST                 *netBufferList,
  [in]      UINT16                          layerId,
  [in]      UINT64                          context,
  [in]      UINT64                          contextTag,
            GUID                            *providerGuid,
  [in, out] void                            *deviceObject,
  [in]      FWPS_NET_BUFFER_LIST_NOTIFY_FN1 notifyFn,
  [in]      UINT32                          flags
);

Parámetros

[in, out] netBufferList

Lista de búferes de red que indica uno o varios paquetes de interés para el controlador de llamada.

[in] layerId

Identificador de la capa en la que se está asociando el contexto. Al llamar a esta función desde la ruta de acceso de recepción de NDIS, establezca este parámetro en FWPS_LAYER_NON_WFP.

[in] context

Información de contexto arbitraria establecida por el controlador de llamada. El motor de filtro pasará este contexto al controlador de llamada.
FWPS_NET_BUFFER_LIST_NOTIFY_FN1 función.

[in] contextTag

Identificador único local obtenido mediante una llamada a Función FwpsNetBufferListGetTagForContext0 .

providerGuid

Guid del proveedor.

[in, out] deviceObject

Puntero al objeto de dispositivo del controlador de llamada.

[in] notifyFn

Puntero a la función FWPS_NET_BUFFER_LIST_NOTIFY_FN1 del controlador de llamada. El motor de filtros enviará notificaciones de estado a esta función.

[in] flags

Este parámetro está reservado para uso futuro y se establece en cero.

Valor devuelto

La función FwpsNetBufferListAssociateContext1 devuelve uno de los siguientes códigos NTSTATUS.

Código devuelto	Descripción
STATUS_SUCCESS	La asociación tuvo éxito.
Otros códigos de estado	Se produjo un error.

Comentarios

La función FwpsNetBufferListAssociateContext1 asocia grupos de paquetes con el controlador de llamada. Se puede realizar un seguimiento de los paquetes de interés para su inspección a través de varias capas de la pila.

Antes de llamar a esta función, se debe llamar a la función FwpsNetBufferListGetTagForContext0 para obtener una etiqueta de contexto.

Esta función es esencialmente idéntica a la versión anterior,

FwpsNetBufferListAssociateContext0. La única diferencia es la función FWPS_NET_BUFFER_LIST_NOTIFY_FN1 actualizada a la que apunta el parámetro notifyFn .

Requisitos

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

Consulte también

FWPS_NET_BUFFER_LIST_NOTIFY_FN1

FwpsNetBufferListAssociateContext0

FwpsNetBufferListGetTagForContext0 FwpsNetBufferListRemoveContext0 FwpsNetBufferListRetrieveContext0

NET_BUFFER_LIST

Uso del etiquetado de paquetes