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