Funzione NdisFSendNetBufferListsComplete (ndis.h)

Articolo
02/26/2024

I driver di filtro chiamano la funzione NdisFSendNetBufferListsComplete per restituire un elenco collegato di strutture di NET_BUFFER_LIST a un driver overlying e per restituire lo stato finale di una richiesta di invio.

Sintassi

void NdisFSendNetBufferListsComplete(
  [in] NDIS_HANDLE      NdisFilterHandle,
       PNET_BUFFER_LIST NetBufferList,
  [in] ULONG            SendCompleteFlags
);

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 .

NetBufferList

Puntatore a un elenco collegato di strutture NET_BUFFER_LIST . Il driver di filtro ha ricevuto le strutture di NET_BUFFER_LIST nelle chiamate precedenti al Funzione FilterSendNetBufferLists .

[in] SendCompleteFlags

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_SEND_COMPLETE_FLAGS_DISPATCH_LEVEL

Specifica che irQL corrente è DISPATCH_LEVEL. Per altre informazioni su questo flag, vedere Dispatch IRQL Tracking.

NDIS_SEND_COMPLETE_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 di NDIS_SEND_FLAGS_SWITCH_SINGLE_SOURCE nel parametro SendFlags di NdisFSendNetBufferLists quando invia la richiesta.

Nota Questo flag è disponibile in NDIS 6.30 e versioni successive.

Valore restituito

nessuno

Osservazioni

Un driver di filtro chiama la funzione NdisFSendNetBufferListsComplete per completare le richieste di invio effettuate da NDIS al driver Funzione FilterSendNetBufferLists . Il driver di filtro specifica un elenco collegato di strutture NET_BUFFER_LIST associate alle richieste di invio completate. Mentre lo stato delle richieste di invio è in sospeso, il driver di filtro mantiene la proprietà delle strutture NET_BUFFER_LIST e tutte le risorse associate alle struttureNET_BUFFER_LIST.

Il driver di filtro può completare le richieste in qualsiasi ordine. Ad esempio, il driver di filtro può concatenare gli elenchi di strutture NET_BUFFER_LIST da più chiamate FilterSendNetBufferLists o suddividere un elenco da una chiamata FilterSendNetBufferLists . Tuttavia, il driver di filtro non deve modificare l'elenco di strutture NET_BUFFER associate a una struttura NET_BUFFER_LIST .

Nota Un driver di filtro deve tenere traccia delle richieste di invio che ha origine e assicurarsi che non chiami Funzione NdisFSendNetBufferListsComplete al termine di tali richieste.

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)