Partager via


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

NDIS_GENERIC_OBJECT

NdisFreeGenericObject