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) |