Funzione NdisFReturnNetBufferLists (ndis.h)

Articolo
02/07/2025

I driver di filtro chiamano NdisFReturnNetBufferLists per rilasciare la proprietà di una o più strutture NET_BUFFER_LIST e delle strutture NET_BUFFER associate.

Sintassi

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

Parametri

[in] NdisFilterHandle

Handle NDIS che identifica questo modulo di filtro. NDIS ha passato l'handle al driver di filtro in una chiamata alla funzione filterAttach FilterAttach.

[in] NetBufferLists

Puntatore a un elenco collegato di strutture NET_BUFFER_LIST che devono essere restituite al driver sottostante. L'elenco collegato può contenere NET_BUFFER_LIST strutture da più chiamate precedenti al funzione FilterReceiveNetBufferLists.

[in] ReturnFlags

Flag NDIS che possono essere combinati con un'operazione OR. Per cancellare tutti i flag, impostare questo membro su zero. Questa funzione supporta i flag seguenti:

NDIS_RETURN_FLAGS_DISPATCH_LEVEL

Specifica che il runtime di integrazione corrente è DISPATCH_LEVEL. Per altre informazioni su questo flag, vedere Dispatch IRQL Tracking.

NDIS_RETURN_FLAGS_SWITCH_SINGLE_SOURCE

Se questo flag è impostato, tutti i pacchetti in un elenco collegato di strutture NET_BUFFER_LIST provengono dalla stessa porta di origine del commutatore estendibile Hyper-V.

Per altre informazioni, vedere Hyper-V flag di invio e ricezione del commutatore estendibile.

Nota Se ogni pacchetto nell'elenco collegato di strutture di NET_BUFFER_LIST utilizza la stessa porta di origine, l'estensione deve impostare il flag NDIS_RECEIVE_FLAGS_SWITCH_SINGLE_SOURCE nel ReceiveFlags parametro di NdisFIndicateReceiveNetBufferLists quando invia la richiesta.

Valore restituito

Nessuno

Osservazioni

Se il flag NDIS_RECEIVE_FLAGS_RESOURCES nel ReceiveFlags parametro passato NDIS funzione FilterReceiveNetBufferLists non è stata impostata, il driver del filtro deve chiamare la funzione di NdisFReturnNetBufferLists per restituire le strutture di NET_BUFFER_LIST e i dati associati. Dopo che il driver del filtro chiama NdisFReturnNetBufferLists, NDIS restituisce i dati al driver sottostante.

Fabbisogno

Requisito	Valore
client minimo supportato	Supportato in NDIS 6.0 e versioni successive.
piattaforma di destinazione	Desktop
intestazione	ndis.h (include Ndis.h)
libreria	Ndis.lib
IRQL	<= DISPATCH_LEVEL
regole di conformità DDI	Irql_Filter_Driver_Function(ndis)