Função FwpsCloneStreamData0 (fwpsk.h)

Artigo
02/07/2025

A função FwpsCloneStreamData0 aloca um clone de um fluxo de dados FWPS_STREAM_DATA0 existente.

ObservaçãoFwpsCloneStreamData0 é uma versão específica do FwpsCloneStreamData. Consulte nomes de Version-Independent WFP e versões específicas de destino do Windows para obter mais informações.

Sintaxe

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

Um ponteiro para a estrutura de FWPS_STREAM_DATA0 original que deve ter sua estrutura NET_BUFFER_LIST clonada.

[in, optional] netBufferListPoolHandle

Um identificador de pool NET_BUFFER_LIST obtido de uma chamada anterior para a função NdisAllocateNetBufferListPool. Esse parâmetro é opcional e pode ser NULL.

[in, optional] netBufferPoolHandle

Um identificador de pool de NET_BUFFER que foi obtido de uma chamada anterior para o função de NdisAllocateNetBufferPool. Esse parâmetro é opcional e pode ser NULL.

[in] allocateCloneFlags

No momento, não há nenhum sinalizador definido para essa função. Os drivers de texto explicativo devem definir esse parâmetro como zero.

[out] netBufferListChain

Um ponteiro para um local que recebe um ponteiro para uma cadeia de estruturas de NET_BUFFER_LIST que descrevem todos os dados de fluxo clonados.

Valor de retorno

A função FwpsCloneStreamData0 retorna um dos seguintes códigos NTSTATUS.

Código de retorno	Descrição
STATUS_SUCCESS	A estrutura de FWPS_STREAM_DATA0 do clone foi alocada com êxito.
Outros códigos de status	Ocorreu um erro.

Observações

Esses dados de fluxo clonados podem ser injetados por um driver de texto explicativo na pilha de rede TCP/IP posteriormente.

A função FwpsCloneStreamData0 clona toda a cadeia de estruturas de NET_BUFFER_LIST contidas no fluxo de dados FWPS_STREAM_DATA0 existente. A função corta dados não utilizados de modo que um driver de texto explicativo possa passar com êxito a cadeia clonada para o função de FwpsStreamInjectAsync0.

Depois que os dados de fluxo na cadeia de estrutura do clone NET_BUFFER_LIST tiverem sido injetados com êxito na pilha de rede, a função de texto explicativo do completionFn será chamada para cada clone NET_BUFFER_LIST estrutura e um texto explicativo deverá chamar FwpsFreeCloneNetBufferList0 para liberar a estrutura de NET_BUFFER_LIST clone.

Um texto explicativo deve chamar a função FwpsDiscardClonedStreamData0 se os dados de fluxo clonados devem ser descartados sem serem reinjetados.

Requisitos

Requisito	Valor
de cliente com suporte mínimo	Disponível a partir do Windows Vista.
da Plataforma de Destino	Universal
cabeçalho	fwpsk.h (inclua Fwpsk.h)
biblioteca	Fwpkclnt.lib
IRQL	<= DISPATCH_LEVEL