Função NdisFReturnNetBufferLists (ndis.h)

Artigo
02/27/2024

Os drivers de filtro chamam NdisFReturnNetBufferLists para liberar a propriedade de uma ou mais estruturas NET_BUFFER_LIST e suas estruturas 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 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 é DISPATCH_LEVEL. Para obter mais informações sobre esse sinalizador, consulte Dispatch IRQL Tracking.

NDIS_RETURN_FLAGS_SWITCH_SINGLE_SOURCE

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

Para obter mais informações, consulte Sinalizadores de envio e recebimento extensíveis do Hyper-V.

Nota 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 quando enviar a solicitação.

Retornar valor

Nenhum

Comentários

Se o sinalizador NDIS_RECEIVE_FLAGS_RESOURCES no parâmetro ReceiveFlags que o NDIS passou para oA 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
Cliente mínimo com suporte	Com suporte no NDIS 6.0 e posterior.
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)