NdisAllocateMdl-Funktion (ndis/mdlapi.h)

Artikel
05/23/2024

Die NdisAllocateMdl-Funktion weist eine MDL zu, die den Speicherpuffer an der angegebenen virtuellen Adresse beschreibt.

Syntax

NDIS_EXPORTED_ROUTINE MDL * NdisAllocateMdl(
  [in] NDIS_HANDLE NdisHandle,
  [in] PVOID       VirtualAddress,
  [in] ULONG       Length
);

Parameter

[in] NdisHandle

Ein NDIS-Handle, das während der Aufruferinitialisierung abgerufen wurde. Weitere Informationen finden Sie unter Abrufen von Poolhandles.

[in] VirtualAddress

Ein Zeiger auf die virtuelle Basisadresse des Puffers, den die MDL beschreiben soll.

Wichtig

Der VirtualAddress-Parameter für NdisAllocateMdl akzeptiert nur Arbeitsspeicher aus dem nicht auspageten Pool. Anders ausgedrückt: Es benötigt Arbeitsspeicher von ExAllocatePool*(NonPagedNx), NdisAllocateMemoryWithTagPriority oder NdisMAllocateSharedMemory. Insbesondere sollte sie nicht mit Arbeitsspeicher aus dem Stapel, dem ausgelagerten Pool, den globalen Treiberdaten oder anderen Speicherregionen verwendet werden.

Wenn ein Treiber eine MDL für eine dieser Nicht-Auslagerpoolregionen erstellen muss, sollte er die entsprechenden Kernel-APIs für diesen Speichertyp verwenden, z. B. IoAllocateMdl in Kombination mit MmProbeAndLockPages.

[in] Length

Die Größe des Speicherpuffers in Bytes.

Rückgabewert

NdisAllocateMdl gibt einen Zeiger auf die zugeordnete MDL zurück. Wenn bei der Zuordnung ein Fehler auftritt, ist der Rückgabewert NULL.

Hinweise

Alle MDLs, die durch aufrufen von NdisAllocateMdl zugewiesen werden, müssen durch Aufrufen der NdisFreeMdl-Funktion freigegeben werden.

NdisAllocateMdl weist Arbeitsspeicher zu und erstellt die MDL in einem Schritt. Dieser Prozess unterscheidet sich von IoAllocateMdl, das nur Arbeitsspeicher für die MDL zuweist, was bedeutet, dass der Aufrufer die MDL erstellen muss, indem er entweder MmBuildMdlForNonPagedPool oder MmProbeAndLockPages aufruft.

Anforderungen

Anforderung	Wert
Unterstützte Mindestversion (Client)	Unterstützt in NDIS 6.0 und höher.
Zielplattform	Universell
UMDF-Mindestversion	2.33
Kopfzeile	ndis/mdlapi.h (include ndis.h)
Bibliothek	Ndis.lib
IRQL	<= DISPATCH_LEVEL
DDI-Complianceregeln	Irql_NetBuffer_Function(ndis), NdisAllocateMdl(ndis)