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) |