Función FwpsNetBufferListRemoveContext0 (fwpsk.h)

  • Artículo

La función FwpsNetBufferListRemoveContext0 quita el contexto asociado a una lista de búferes de red.

NotaFwpsNetBufferListRemoveContext0 es una versión específica de FwpsNetBufferListRemoveContext. Para obtener más información, consulte NOMBRES de PMA Version-Independent y versiones específicas de destino de Windows .
 

Sintaxis

NTSTATUS FwpsNetBufferListRemoveContext0(
  [in, out, optional] NET_BUFFER_LIST *netBufferList,
  [in]                UINT64          contextTag,
  [in]                UINT32          flags
);

Parámetros

[in, out, optional] netBufferList

Lista de búferes de red que indica uno o varios paquetes de interés para el controlador de llamada. Este parámetro es opcional y puede ser NULL. Si es NULL, la función quitará el contexto de todas las listas de búferes de red asociadas.

[in] contextTag

Etiqueta de contexto que se pasó en el parámetro contextTag a FwpsNetBufferListAssociateContext0.

[in] flags

Este parámetro está reservado para uso futuro y debe ser cero.

Valor devuelto

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

Código devuelto Descripción
STATUS_SUCCESS
 El contexto se quitó correctamente.
Otros códigos de estado
 Se produjo un error.

Comentarios

La función FwpsNetBufferListRemoveContext0 quita de forma asincrónica el contexto etiquetado asociado a una lista de búferes de red.

Para asociar un contexto a una lista de búferes de red, llame a FwpsNetBufferListAssociateContext0 o FwpsNetBufferListAssociateContext1.

Normalmente, un controlador de llamada no tendrá que usar esta función, ya que el contexto etiquetado se quita automáticamente cuando los paquetes se mueven a través de la pila. Esta función se proporciona para que un controlador de llamada pueda detener el procesamiento en situaciones en las que los contextos no se quitan automáticamente. Por ejemplo, en el caso de un controlador de filtro NDIS, los paquetes nunca entran en la pila TCP/IP y los contextos deberán quitarse manualmente llamando a FwpsNetBufferListRemoveContext0 con el parámetro netBufferList establecido en NULL.

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

FwpsNetBufferListAssociateContext0

FwpsNetBufferListAssociateContext1

FwpsNetBufferListGetTagForContext0 FwpsNetBufferListRetrieveContext0

NET_BUFFER_LIST

Uso del etiquetado de paquetes