Função NdisFReturnNetBufferLists (ndis.h)

Artigo
02/07/2025

Os drivers de filtro chamam NdisFReturnNetBufferLists para liberar a propriedade de uma ou mais estruturas NET_BUFFER_LIST e suas estruturas de NET_BUFFER associadas.

Sintaxe

void NdisFReturnNetBufferLists(
  [in] NDIS_HANDLE      NdisFilterHandle,
  [in] PNET_BUFFER_LIST NetBufferLists,
  [in] ULONG            ReturnFlags
);

Parâmetros

[in] NdisFilterHandle

O identificador NDIS que identifica esse módulo de filtro. O NDIS passou o identificador para o driver de filtro em uma chamada para a função FilterAttach.

[in] NetBufferLists

Um ponteiro para uma lista vinculada de estruturas de NET_BUFFER_LIST que devem ser retornadas ao driver subjacente. A lista vinculada pode conter estruturas de NET_BUFFER_LIST de várias chamadas anteriores para o função FilterReceiveNetBufferLists.

[in] ReturnFlags

Sinalizadores NDIS que podem ser combinados com uma operação OR. Para limpar todos os sinalizadores, defina esse membro como zero. Essa função dá suporte aos seguintes sinalizadores:

NDIS_RETURN_FLAGS_DISPATCH_LEVEL

Especifica que o IRQL atual está DISPATCH_LEVEL. Para obter mais informações sobre esse sinalizador, consulte de Acompanhamento de IRQL de Expedição.

NDIS_RETURN_FLAGS_SWITCH_SINGLE_SOURCE

Se esse sinalizador for definido, todos os pacotes em uma lista vinculada de estruturas de NET_BUFFER_LIST se originaram da mesma porta de origem do comutador extensível Hyper-V.

Para obter mais informações, consulte Hyper-V Sinalizadores de Envio e Recebimento Extensíveis do Comutador.

Observação Se cada pacote na lista vinculada de estruturas de NET_BUFFER_LIST usar a mesma porta de origem, a extensão deverá definir o sinalizador NDIS_RECEIVE_FLAGS_SWITCH_SINGLE_SOURCE no parâmetro ReceiveFlags de NdisFIndicateReceiveNetBufferLists ao enviar a solicitação.

Valor de retorno

Nenhum

Observações

Se o sinalizador NDIS_RECEIVE_FLAGS_RESOURCES no parâmetro ReceiveFlags que o NDIS passou para o função FilterReceiveNetBufferLists não foi definida, o driver de filtro deve chamar a função NdisFReturnNetBufferLists para retornar as estruturas NET_BUFFER_LIST e os dados associados. Depois que o driver de filtro chama NdisFReturnNetBufferLists, o NDIS retorna os dados para o driver subjacente.

Requisitos

Requisito	Valor
de cliente com suporte mínimo	Com suporte no NDIS 6.0 e posterior.
da Plataforma de Destino	Área de trabalho
cabeçalho	ndis.h (inclua Ndis.h)
biblioteca	Ndis.lib
IRQL	<= DISPATCH_LEVEL
regras de conformidade de DDI	Irql_Filter_Driver_Function(ndis)

Consulte também

FilterAttach

FilterReceiveNetBufferLists

NET_BUFFER

NET_BUFFER_LIST

Compartilhar via