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.
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
);
[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.
La función FwpsNetBufferListAssociateContext1 devuelve uno de los siguientes códigos NTSTATUS.
Código devuelto | Descripción |
---|---|
|
La asociación tuvo éxito. |
|
Se produjo un error. |
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 .
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 |
FWPS_NET_BUFFER_LIST_NOTIFY_FN1
FwpsNetBufferListAssociateContext0
FwpsNetBufferListGetTagForContext0 FwpsNetBufferListRemoveContext0 FwpsNetBufferListRetrieveContext0