Función FwpsNetBufferListAssociateContext0 (fwpsk.h)

  • Artículo

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

NotaFwpsNetBufferListAssociateContext0 es la versión específica de FwpsNetBufferListAssociateContext que se usa 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, FwpsNetBufferListAssociateContext1 está disponible.
 

Sintaxis

NTSTATUS FwpsNetBufferListAssociateContext0(
  [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_FN0 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_FN0.

[in] contextTag

Un identificador único localmente 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 al controlador de llamada FWPS_NET_BUFFER_LIST_NOTIFY_FN0 función. 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 FwpsNetBufferListAssociateContext0 devuelve uno de los siguientes códigos NTSTATUS.

Código devuelto Descripción
STATUS_SUCCESS
 La asociación se realizó correctamente.
Otros códigos de estado
 Se produjo un error.

Comentarios

La función FwpsNetBufferListAssociateContext0 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.

Requisitos

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

Consulte también

FwpsNetBufferListAssociateContext1

FwpsNetBufferListGetTagForContext0 FwpsNetBufferListRemoveContext0 FwpsNetBufferListRetrieveContext0

NET_BUFFER_LIST

Uso del etiquetado de paquetes