NdisAllocateGenericObject, fonction (ndis.h)
Les composants qui n’ont pas de handle NDIS utilisent la fonction NdisAllocateGenericObject pour allouer un objet NDIS générique.
Syntaxe
PNDIS_GENERIC_OBJECT NdisAllocateGenericObject(
[optional] PDRIVER_OBJECT DriverObject,
ULONG Tag,
USHORT Size
);
Paramètres
[optional] DriverObject
Objet pilote à associer à l’objet générique. Ce paramètre peut être NULL.
Tag
Balise de mémoire du noyau que NDIS doit utiliser pour allouer de la mémoire à l’objet générique.
Size
Quantité de mémoire, en octets, à réserver pour l’appelant. Cela n’inclut pas la taille de la structure NDIS_GENERIC_OBJECT . Utilisez l’espace mémoire supplémentaire à vos propres fins. Pour accéder à la mémoire supplémentaire, utilisez sizeof(NDIS_GENERIC_OBJECT) pour ignorer la structure d’objet générique.
Valeur retournée
NdisAllocateGenericObject retourne un pointeur vers le NDIS_GENERIC_OBJECT qu’il a alloué. Si NDIS n’a pas pu créer l’objet, la valeur de retour est NULL.
Remarques
NDIS utilise un objet générique pour gérer les ressources allouées par un composant qui n’a pas de handle NDIS. Un tel composant utilise le pointeur d’objet générique retourné comme handle NDIS dans certaines API d’allocation de ressources NDIS qui nécessitent un handle NDIS.
Les pilotes NDIS doivent appeler la fonction NdisFreeGenericObject pour libérer un objet générique créé avec NdisAllocateGenericObject.
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),NdisAllocateGenericObject(ndis) |