NDIS_GENERIC_OBJECT structure (ndis.h)
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) |