NdisAllocateMemoryWithTagPriority, fonction (ndis.h)

Article
03/01/2024

Les pilotes NDIS appellent la fonction NdisAllocateMemoryWithTagPriority pour allouer un pool de mémoire à partir du pool non paginé.

Syntaxe

PVOID NdisAllocateMemoryWithTagPriority(
  [in] NDIS_HANDLE      NdisHandle,
  [in] UINT             Length,
  [in] ULONG            Tag,
  [in] EX_POOL_PRIORITY Priority
);

Paramètres

[in] NdisHandle

Un handle NDIS que l’appelant a obtenu lors de l’initialisation. Par exemple, un pilote miniport peut utiliser le handle NDIS qu’il a obtenu à partir du Fonction NdisMRegisterMiniportDriver ou MiniportInitializeEx . D’autres pilotes NDIS peuvent utiliser les handles des fonctions suivantes :

NdisRegisterProtocolDriver

NdisOpenAdapterEx

NdisFRegisterFilterDriver

FilterAttach

[in] Length

Taille à allouer, en octets.

[in] Tag

Chaîne, délimitée par des guillemets simples, avec jusqu’à quatre caractères, généralement spécifiée dans l’ordre inverse. La balise par défaut fournie par NDIS pour cet appel est « maDN », mais l’appelant peut remplacer cette valeur par défaut en fournissant une valeur explicite.

[in] Priority

L’importance de cette demande. Pour plus d'informations, consultez la rubrique ExAllocatePoolWithTagPriority.

Valeur retournée

NdisAllocateMemoryWithTagPriority retourne un pointeur vers une adresse virtuelle de base de la mémoire allouée, ou NULL si suffisamment de mémoire non paginé n’est actuellement pas disponible.

Remarques

Pour libérer la mémoire allouée avec NdisAllocateMemoryWithTagPriority, appelez la fonction NdisFreeMemoryWithTagPriority ou NdisFreeMemory .

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.h (inclure Ndis.h)
Bibliothèque	Ndis.lib
IRQL	<= DISPATCH_LEVEL
Règles de conformité DDI	Irql_Miscellaneous_Function(ndis),NdisAllocateMemoryWithTagPriority(ndis), NdisAllocateMemoryWithTagPriority_Cleanup(ndis), NdisAllocateMemoryWithTagPriority_InitFail(ndis)