Función FwpsCloneStreamData0 (fwpsk.h)

Artículo
02/26/2024

La función FwpsCloneStreamData0 asigna un clon de un flujo de datos de FWPS_STREAM_DATA0 existente.

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

Sintaxis

NTSTATUS FwpsCloneStreamData0(
  [in, out]      FWPS_STREAM_DATA0 *calloutStreamData,
  [in, optional] NDIS_HANDLE       netBufferListPoolHandle,
  [in, optional] NDIS_HANDLE       netBufferPoolHandle,
  [in]           ULONG             allocateCloneFlags,
  [out]          NET_BUFFER_LIST   **netBufferListChain
);

Parámetros

[in, out] calloutStreamData

Puntero a la estructura FWPS_STREAM_DATA0 original que va a tener clonada su estructura de NET_BUFFER_LIST .

[in, optional] netBufferListPoolHandle

Identificador NET_BUFFER_LIST grupo que se obtuvo de una llamada anterior a la función NdisAllocateNetBufferListPool . Este parámetro es opcional y puede ser NULL.

[in, optional] netBufferPoolHandle

Identificador de grupo de NET_BUFFER que se obtuvo de una llamada anterior a . Función NdisAllocateNetBufferPool . Este parámetro es opcional y puede ser NULL.

[in] allocateCloneFlags

Actualmente no hay marcas definidas para esta función. Los controladores de llamada deben establecer este parámetro en cero.

[out] netBufferListChain

Puntero a una ubicación que recibe un puntero a una cadena de estructuras de NET_BUFFER_LIST que describen todos los datos de flujo clonados.

Valor devuelto

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

Código devuelto	Descripción
STATUS_SUCCESS	La estructura de FWPS_STREAM_DATA0 clonada se asignó correctamente.
Otros códigos de estado	Se produjo un error.

Comentarios

Este flujo clonado puede insertarse mediante un controlador de llamada en la pila de red TCP/IP más adelante.

La función FwpsCloneStreamData0 clona toda la cadena de estructuras de NET_BUFFER_LIST contenidas en el flujo de datos FWPS_STREAM_DATA0 existente. La función recorta los datos sin usar para que un controlador de llamada pueda pasar correctamente la cadena clonada a . Función FwpsStreamInjectAsync0 .

Después de insertar correctamente los datos de secuencia en la cadena de estructura de NET_BUFFER_LIST clonado en la pila de red, se llama a la función de llamada completionFn para cada estructura de NET_BUFFER_LIST clonada y una llamada debe llamar a FwpsFreeCloneNetBufferList0 para liberar la estructura del NET_BUFFER_LIST clonado.

Una llamada debe llamar a la función FwpsDiscardClonedStreamData0 si los datos de secuencia clonados se van a descartar sin volver a insertarse.

Requisitos

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