NdisAllocateNetBufferMdlAndData, fonction (ndis/nblapi.h)

  • Article

Les pilotes NDIS appellent la fonction NdisAllocateNetBufferMdlAndData pour allouer une structure NET_BUFFER, ainsi que les données et mdL associées.

Syntaxe

NDIS_EXPORTED_ROUTINE NET_BUFFER * NdisAllocateNetBufferMdlAndData(
  [in] NDIS_HANDLE PoolHandle
);

Paramètres

[in] PoolHandle

Un NET_BUFFER handle de pool de structure qui a été précédemment retourné à partir d’un appel à la fonction NdisAllocateNetBufferPool .

Valeur retournée

NdisAllocateNetBufferMdlAndData retourne un pointeur vers la structure NET_BUFFER allouée par NDIS. Si l’allocation a échoué, ce pointeur a la valeur NULL.

Remarques

L’appelant doit appeler la fonction NdisAllocateNetBufferPool et spécifier la taille maximale des mémoires tampons de données. Compte tenu de cette valeur, NDIS peut préallouer des mémoires tampons pour l’appelant.

Cette fonction alloue une structure NET_BUFFER , MDL et des données dans une mémoire tampon unique. Cela est utile pour obtenir des performances élevées lorsque NET_BUFFER structures sont fréquemment allouées et libérées. L’appelant ne doit pas appeler NdisAllocateNetBuffer pour allouer des NET_BUFFERs hors NET_BUFFER pools qui contiennent des données.

NDIS utilise le paramètre PoolHandle pour obtenir un bloc de mémoire, puis crée les NET_BUFFER, MDL et la mémoire tampon de données.

Pour libérer le NET_BUFFER et les informations associées, appelez la fonction NdisFreeNetBuffer .

Configuration requise

Condition requise Valeur
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),NdisAllocateNetBufferMdlAndData(ndis), NdisAllocateNetBufferMdlAndData_InitFail(ndis)

Voir aussi

NET_BUFFER

NdisAllocateNetBuffer

NdisFreeNetBuffer