Compartir a través de

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 para eventos de lista de búferes de red.

NotafwpsNetBufferListAssociateContext0 es la versión específica de fwpsNetBufferListAssociateContext usada en Windows 7 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 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

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 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
 Error.

Observaciones

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 Valor
cliente mínimo admitido Disponible a partir de Windows 7.
de la plataforma de destino de Universal
encabezado de fwpsk.h (incluya Fwpsk.h)
biblioteca de Fwpkclnt.lib
irQL <= DISPATCH_LEVEL

Consulte también

fwpsNetBufferListAssociateContext1

FwpsNetBufferListGetTagForContext0 FwpsNetBufferListRemoveContext0 FwpsNetBufferListRetrieveContext0

NET_BUFFER_LIST

usar de etiquetado de paquetes