NdisAllocateGenericObject-Funktion (ndis.h)

Komponenten ohne NDIS-Handle verwenden die NdisAllocateGenericObject-Funktion , um ein generisches NDIS-Objekt zuzuordnen.

Syntax

PNDIS_GENERIC_OBJECT NdisAllocateGenericObject(
  [optional] PDRIVER_OBJECT DriverObject,
             ULONG          Tag,
             USHORT         Size
);

Parameter

[optional] DriverObject

Ein Treiberobjekt, das dem generischen Objekt zugeordnet werden soll. Dieser Parameter kann NULL sein.

Tag

Das Kernelspeichertag, das NDIS verwenden soll, um Arbeitsspeicher für das generische Objekt zuzuweisen.

Size

Die Menge an Arbeitsspeicher in Bytes, die für den Aufrufer reserviert werden soll. Dies schließt nicht die Größe der NDIS_GENERIC_OBJECT-Struktur ein. Verwenden Sie den zusätzlichen Speicherplatz für Ihre eigenen Zwecke. Um auf den zusätzlichen Arbeitsspeicher zuzugreifen, verwenden Sie sizeof(NDIS_GENERIC_OBJECT), um die generische Objektstruktur zu überspringen.

Rückgabewert

NdisAllocateGenericObject gibt einen Zeiger auf die zugeordnete NDIS_GENERIC_OBJECT zurück. Wenn NDIS das Objekt nicht erstellen konnte, ist der Rückgabewert NULL.

Hinweise

NDIS verwendet ein generisches Objekt, um Ressourcen zu verwalten, die von einer Komponente zugeordnet werden, die andernfalls kein NDIS-Handle hat. Eine solche Komponente verwendet den zurückgegebenen generischen Objektzeiger als NDIS-Handle in einigen NDIS-Ressourcenzuordnungs-APIs, die ein NDIS-Handle erfordern.

NDIS-Treiber müssen die NdisFreeGenericObject-Funktion aufrufen, 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.
Zielplattform	Universell
Header	ndis.h (include Ndis.h)
Bibliothek	Ndis.lib
IRQL	<= DISPATCH_LEVEL
DDI-Complianceregeln	Irql_Miscellaneous_Function(ndis), NdisAllocateGenericObject(ndis)

Weitere Informationen

NDIS_GENERIC_OBJECT

NdisFreeGenericObject