NDIS_GENERIC_OBJECT-Struktur (ndis.h)

  • Artikel

Die NDIS_GENERIC_OBJECT-Struktur definiert ein generisches Objekt, das eine Softwarekomponente verwenden kann, um ein NDIS-Handle abzurufen.

Syntax

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

Member

Header

Die NDIS_OBJECT_HEADER-Struktur für die generische Objektstruktur (NDIS_GENERIC_OBJECT). NDIS legt den Typmember der Struktur fest, die Header für NDIS_OBJECT_TYPE_GENERIC_OBJECT, den Revisionsmember auf NDIS_GENERIC_OBJECT_REVISION_1 und das Size-Element auf sizeof(NDIS_GENERIC_OBJECT).

Caller

Reserviert für NDIS.

CallersCaller

Reserviert für NDIS.

DriverObject

Das Treiberobjekt, das dem generischen Objekt zugeordnet ist. Wenn kein Treiberobjekt vorhanden ist, ist dieses Element NULL. Dies ist der Wert, der am DriverObject-Parameter des NdisAllocateGenericObject-Funktion .

Hinweise

Softwarekomponenten, die noch nicht über ein NDIS-Handle verfügen, rufen NdisAllocateGenericObject auf, um ein generisches Objekt zu erstellen. Solche Komponenten verwenden das aus NdisAllocateGenericObject abgerufene Handle, um NDIS-Ressourcen zuzuordnen.

Der Size-Parameter von NdisAllocateGenericObject gibt eine Menge an Arbeitsspeicher in Bytes an, die für den Aufrufer reserviert werden soll. NdisAllocateGenericObject fügt den zusätzlichen Arbeitsspeicher nach dem NDIS_OBJECT_STRUCTURE-Membern hinzu.

Die meisten NDIS-Treiber erfordern kein generisches Objekt, um ein Handle abzurufen. NDIS-Protokoll-, Zwischen- und Miniporttreiber erhalten während der Initialisierung ein Handle.

Verwenden Sie die NdisFreeGenericObject-Funktion , um ein generisches Objekt frei zu geben, das mit NdisAllocateGenericObject erstellt wurde.

Anforderungen

Anforderung Wert
Unterstützte Mindestversion (Client) Unterstützt in NDIS 6.0 und höher.
Kopfzeile ndis.h (include Ndis.h)

Weitere Informationen

NDIS_OBJECT_HEADER

NdisAllocateGenericObject

NdisFreeGenericObject