Función FwpsCloneStreamData0 (fwpsk.h)

Artículo
02/07/2025

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

NotafwpsCloneStreamData0 es una versión específica de FwpsCloneStreamData. Consulta nombres Version-Independent DEL PMA y destinatarios de versiones específicas de Windows para obtener más información.

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 su estructura NET_BUFFER_LIST clonada.

[in, optional] netBufferListPoolHandle

Identificador de grupo de NET_BUFFER_LIST que se obtuvo de una llamada anterior a la función NdisAllocateNetBufferListPool. Este parámetro es opcional y se puede 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 se puede 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 NET_BUFFER_LIST estructuras 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 FWPS_STREAM_DATA0 clonada se asignó correctamente.
otros códigos de estado	Error.

Observaciones

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 de forma 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 NET_BUFFER_LIST clonado en la pila de red, se llama a la función de llamada completeFn para cada estructura de NET_BUFFER_LIST clonada y una llamada debe llamar a FwpsFreeCloneNetBufferList0 para liberar la estructura NET_BUFFER_LIST clonada.

Una llamada debe llamar a la función FwpsDiscardClonedStreamData0 si se van a descartar los datos del flujo clonado sin volver a insertarse.

Requisitos

Requisito	Valor
cliente mínimo admitido	Disponible a partir de Windows Vista.
de la plataforma de destino de	Universal
encabezado de	fwpsk.h (incluya Fwpsk.h)
biblioteca de	Fwpkclnt.lib
irQL	<= DISPATCH_LEVEL