NdisAllocateMemoryWithTagPriority, fonction (ndis.h)
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 :
[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) |