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) |
Voir aussi
Commentaires
https://aka.ms/ContentUserFeedback.
Bientôt disponible : Tout au long de 2024, nous allons supprimer progressivement GitHub Issues comme mécanisme de commentaires pour le contenu et le remplacer par un nouveau système de commentaires. Pour plus d’informations, consultezEnvoyer et afficher des commentaires pour