NDIS_GENERIC_OBJECT structure (ndis.h)

  • Article

La structure NDIS_GENERIC_OBJECT définit un objet générique qu’un composant logiciel peut utiliser pour obtenir un handle NDIS.

Syntaxe

typedef struct _NDIS_GENERIC_OBJECT {
  NDIS_OBJECT_HEADER Header;
  PVOID              Caller;
  PVOID              CallersCaller;
  PDRIVER_OBJECT     DriverObject;
} NDIS_GENERIC_OBJECT, *PNDIS_GENERIC_OBJECT;

Membres

Header

Structure NDIS_OBJECT_HEADER de la structure d’objet générique (NDIS_GENERIC_OBJECT). NDIS définit le membre Type de la structure que Header spécifie sur NDIS_OBJECT_TYPE_GENERIC_OBJECT, le membre Revision sur NDIS_GENERIC_OBJECT_REVISION_1 et le membre Size sur sizeof(NDIS_GENERIC_OBJECT).

Caller

Réservé pour NDIS.

CallersCaller

Réservé pour NDIS.

DriverObject

Objet driver associé à l’objet générique. S’il n’y a pas d’objet pilote, ce membre est NULL. Il s’agit de la valeur passée au paramètre DriverObject du Fonction NdisAllocateGenericObject .

Remarques

Les composants logiciels qui n’ont pas encore de handle NDIS appellent NdisAllocateGenericObject pour créer un objet générique. Ces composants utilisent le handle obtenu à partir de NdisAllocateGenericObject pour allouer des ressources NDIS.

Le paramètre Size de NdisAllocateGenericObject spécifie une quantité de mémoire, en octets, à réserver pour l’appelant. NdisAllocateGenericObject ajoute la mémoire supplémentaire après les membres NDIS_OBJECT_STRUCTURE.

La plupart des pilotes NDIS ne nécessitent pas d’objet générique pour obtenir un handle. Les pilotes de protocole NDIS, intermédiaires et miniport obtiennent un handle lors de l’initialisation.

Utilisez 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.
En-tête ndis.h (inclure Ndis.h)

Voir aussi

NDIS_OBJECT_HEADER

NdisAllocateGenericObject

NdisFreeGenericObject