NdisFReturnNetBufferLists, fonction (ndis.h)

Article
03/05/2024

Les pilotes de filtre appellent NdisFReturnNetBufferLists pour libérer la propriété d’une ou de plusieurs structures NET_BUFFER_LIST et de 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 à Fonction FilterReceiveNetBufferLists .

[in] ReturnFlags

Indicateurs NDIS qui peuvent être combinés avec 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 l’IRQL 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 Indicateurs d’envoi et de réception du commutateur extensible Hyper-V.

Note 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 lorsqu’elle envoie la demande.

Valeur de retour

None

Remarques

Si le NDIS_RECEIVE_FLAGS_RESOURCES indicateur dans le paramètre ReceiveFlags que NDIS a passé à La 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 a appelé NdisFReturnNetBufferLists, NDIS retourne les données au pilote sous-jacent.

Configuration requise

Condition requise	Valeur
Client minimal pris en charge	Pris en charge dans NDIS 6.0 et versions ultérieures.
Plateforme cible	Desktop (Expérience utilisateur)
En-tête	ndis.h (inclure Ndis.h)
Bibliothèque	Ndis.lib
IRQL	<= DISPATCH_LEVEL
Règles de conformité DDI	Irql_Filter_Driver_Function(ndis)