Funzione NdisFReturnNetBufferLists (ndis.h)

Articolo
08/07/2023

I driver di filtro chiamano NdisFReturnNetBufferLists per rilasciare la proprietà di una o più strutture NET_BUFFER_LIST e le 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 .

[in] NetBufferLists

Puntatore a un elenco collegato di strutture NET_BUFFER_LIST da restituire al driver sottostante. L'elenco collegato può contenere strutture NET_BUFFER_LIST 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 irQL 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 hanno origine dalla stessa porta di origine del commutatore estendibile Hyper-V.

Per altre informazioni, vedere Invio e ricezione del commutatore estendibile Hyper-V.

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

Valore restituito

nessuno

Osservazioni

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

Requisiti

Requisito	Valore
Client minimo supportato	Supportato in NDIS 6.0 e versioni successive.
Piattaforma di destinazione	Desktop
Intestazione	ndis.h (includere Ndis.h)
Libreria	Ndis.lib
IRQL	<= DISPATCH_LEVEL
Regole di conformità DDI	Irql_Filter_Driver_Function(ndis)