NdisAllocateGenericObject-Funktion (ndis.h)
Komponenten, die nicht über einen NDIS-Handle verfügen, verwenden die NdisAllocateGenericObject--Funktion, um ein generisches NDIS-Objekt zuzuweisen.
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 Speicher für das generische Objekt zuzuweisen.
Size
Die Speichermenge in Bytes, die für den Anrufer 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 NDIS_GENERIC_OBJECT zurück, die sie zugewiesen hat. Wenn NDIS das Objekt nicht erstellt hat, ist der Rückgabewert NULL-.
Bemerkungen
NDIS verwendet ein generisches Objekt zum Verwalten von Ressourcen, die von einer Komponente zugeordnet werden, die andernfalls nicht über ein NDIS-Handle verfügt. 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 freizulegen, das mit NdisAllocateGenericObjecterstellt wurde.
Anforderungen
| Anforderung | Wert |
|---|---|
| mindestens unterstützte Client- | Unterstützt in NDIS 6.0 und höher. |
| Zielplattform- | Universal |
| Header- | ndis.h (include Ndis.h) |
| Library | Ndis.lib |
| IRQL- | <= DISPATCH_LEVEL |
| DDI-Complianceregeln | Irql_Miscellaneous_Function(ndis), NdisAllocateGenericObject(ndis) |