Partager via


NdisFReturnNetBufferLists, fonction (ndis.h)

Les pilotes de filtre appellent NdisFReturnNetBufferLists pour libérer la propriété d’une ou plusieurs structures NET_BUFFER_LIST et leurs structures NET_BUFFER associées.

Syntaxe

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

Paramètres

[in] NdisFilterHandle

Handle NDIS qui identifie ce module de filtre. NDIS a passé le handle au pilote de filtre dans un appel à la fonction FilterAttach.

[in] NetBufferLists

Pointeur vers une liste liée de structures NET_BUFFER_LIST qui doivent être retournées au pilote sous-jacent. La liste liée peut contenir des structures NET_BUFFER_LIST de plusieurs appels précédents au FilterReceiveNetBufferLists fonction.

[in] ReturnFlags

Indicateurs NDIS qui peuvent être combinés à une opération OR. Pour effacer tous les indicateurs, définissez ce membre sur zéro. Cette fonction prend en charge les indicateurs suivants :

NDIS_RETURN_FLAGS_DISPATCH_LEVEL

Spécifie que le runtime d’intégration actuel est DISPATCH_LEVEL. Pour plus d’informations sur cet indicateur, consultez Dispatch IRQL Tracking.

NDIS_RETURN_FLAGS_SWITCH_SINGLE_SOURCE

Si cet indicateur est défini, tous les paquets d’une liste liée de structures NET_BUFFER_LIST proviennent du même port source de commutateur extensible Hyper-V.

Pour plus d’informations, consultez Hyper-V indicateurs d’envoi et de réception extensibles.

Remarque Si chaque paquet de la liste liée de structures NET_BUFFER_LIST utilise le même port source, l’extension doit définir l’indicateur NDIS_RECEIVE_FLAGS_SWITCH_SINGLE_SOURCE dans le paramètre ReceiveFlags de NdisFIndicateReceiveNetBufferLists lors de l’envoi de la requête.
 

Valeur de retour

Aucun

Remarques

Si l’indicateur NDIS_RECEIVE_FLAGS_RESOURCES dans la ReceiveFlags paramètre transmis à NDIS fonction FilterReceiveNetBufferLists n’a pas été définie, le pilote de filtre doit appeler la fonction NdisFReturnNetBufferLists pour retourner les structures NET_BUFFER_LIST et les données associées. Une fois que le pilote de filtre appelle NdisFReturnNetBufferLists, NDIS retourne les données au pilote sous-jacent.

Exigences

Exigence Valeur
client minimum pris en charge Prise en charge dans NDIS 6.0 et versions ultérieures.
plateforme cible Bureau
d’en-tête ndis.h (include Ndis.h)
bibliothèque Ndis.lib
IRQL <= DISPATCH_LEVEL
règles de conformité DDI Irql_Filter_Driver_Function(ndis)

Voir aussi

FilterAttach

FilterReceiveNetBufferLists

NET_BUFFER

NET_BUFFER_LIST