NdisAllocateCloneNetBufferList, fonction (ndis/nblapi.h)

Appelez la fonction NdisAllocateCloneNetBufferList pour créer un clone NET_BUFFER_LIST structure.

Syntaxe

NDIS_EXPORTED_ROUTINE NET_BUFFER_LIST * NdisAllocateCloneNetBufferList(
  [in]           NET_BUFFER_LIST *OriginalNetBufferList,
  [in, optional] NDIS_HANDLE     NetBufferListPoolHandle,
  [in, optional] NDIS_HANDLE     NetBufferPoolHandle,
  [in]           ULONG           AllocateCloneFlags
);

Paramètres

[in] OriginalNetBufferList

Pointeur vers une structure NET_BUFFER_LIST existante.

[in, optional] NetBufferListPoolHandle

Un handle obtenu à partir d’un appel au Fonction NdisAllocateNetBufferListPool .

[in, optional] NetBufferPoolHandle

Handle de pool de structures NET_BUFFER qui a été retourné précédemment à partir d’un appel à NdisAllocateNetBufferPool.

[in] AllocateCloneFlags

Indicateurs NDIS qui peuvent être combinés à une opération OR. Les indicateurs suivants sont définis :

NDIS_CLONE_FLAGS_RESERVED

Réservé à NDIS.

NDIS_CLONE_FLAGS_USE_ORIGINAL_MDLS

Si cet indicateur est défini, NDIS n’alloue pas de nouveaux MDL pour le NET_BUFFER_LIST cloné. Au lieu de cela, le NET_BUFFER_LIST cloné utilise la même chaîne MDL que la NET_BUFFER_LIST d’origine. Si NDIS_CLONE_FLAGS_USE_ORIGINAL_MDLS est effacé, NDIS alloue de nouveaux MDL pour référencer les mémoires tampons de données d’origine.

Valeur retournée

NdisAllocateCloneNetBufferList retourne un pointeur vers la nouvelle structure NET_BUFFER_LIST clone. Si l’allocation a échoué, ce pointeur a la valeur NULL.

Notes

Appelez NdisAllocateCloneNetBufferList pour créer un clone NET_BUFFER_LIST structure que vous pouvez utiliser pour envoyer des données en double sur un chemin de données distinct.

Chaque structure NET_BUFFER de la structure de NET_BUFFER_LIST d’origine n’est cloné qu’au début de l’espace de données utilisé, et non au début de l’espace de données entier. Pour obtenir le décalage entre le début de l’espace de données et le début de l’espace de données utilisé, utilisez la macro NET_BUFFER_DATA_OFFSET .

Si la structure NET_BUFFER_LIST cloné doit avoir des attributs associés à un pool donné, l’appelant doit spécifier le handle de pool dans le paramètre NetBufferListPoolHandle ou NetBufferPoolHandle . Par exemple, le membre ProtocolType de la structure NET_BUFFER_LIST est associé au pool.

Le clone NET_BUFFER_LIST structure décrit les mêmes données que celles décrites par la structure NET_BUFFER_LIST sur OriginalNetBufferList. NDIS ne copie pas les données décrites par les MDL d’origine vers de nouvelles mémoires tampons de données. Au lieu de cela, les structures clonées font référence aux mémoires tampons de données d’origine. La structure de NET_BUFFER_LIST clone n’inclut pas de structure initiale NET_BUFFER_LIST_CONTEXT structure.

Appeler le Fonction NdisFreeCloneNetBufferList pour libérer une structure NET_BUFFER_LIST et toutes les structures et chaînes MDL associées qui ont été allouées en appelant NdisAllocateCloneNetBufferList.

Spécifications

   
Client minimal pris en charge Pris en charge dans NDIS 6.0 et versions ultérieures.
Plateforme cible Universal
En-tête ndis/nblapi.h (include ndis.h)
Bibliothèque Ndis.lib
IRQL <= DISPATCH_LEVEL
Règles de conformité DDI Irql_NetBuffer_Function(ndis), NdisAllocateCloneNetBufferList(ndis), NdisAllocateCloneNetBufferList_InitFail(ndis)

Voir aussi

NET_BUFFER

NET_BUFFER_LIST

NET_BUFFER_LIST_CONTEXT

NdisAllocateNetBufferListPool

NdisAllocateNetBufferPool

NdisFreeCloneNetBufferList