Función FwpsCloneStreamData0 (fwpsk.h)
La función FwpsCloneStreamData0 asigna un clon de un flujo de datos de FWPS_STREAM_DATA0 existente.
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 |
|---|---|
|
La estructura de FWPS_STREAM_DATA0 clonada se asignó correctamente. |
|
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 |