IoFreeMdl-Funktion (wdm.h)

  • Artikel

Die IoFreeMdl-Routine gibt eine vom Aufrufer zugeordnete Speicherdeskriptorliste (MDL) frei.

Syntax

void IoFreeMdl(
  [in] PMDL Mdl
);

Parameter

[in] Mdl

Zeiger auf die MDL, die freigegeben werden soll.

Rückgabewert

Keine

Bemerkungen

Wenn ein Treiber eine MDL zur Beschreibung eines Puffers zuordnet, muss er die MDL explizit freigeben, wenn Vorgänge für den Puffer ausgeführt werden.

Wenn es sich bei der MDL um eine partielle MDL handelt, hebt IoFreeMdl die Zuordnung aller Seiten auf, die der MDL zugeordnet wurden.

Wenn die physischen Seiten, die von der MDL beschrieben werden, gesperrt sind, muss der Treiber die Seiten entsperren, bevor er die MDL freigibt.

Diese Routine gibt nur die angegebene MDL frei. Alle MDLs, die mit dieser MDL verkettet sind, müssen explizit durch zusätzliche Aufrufe dieser Routine freigegeben werden. Ein Codebeispiel zum Freigeben einer MDL-Kette finden Sie unter Verwenden von MDLs.

Anforderungen

Anforderung Wert
Unterstützte Mindestversion (Client) Verfügbar ab Windows 2000.
Zielplattform Universell
Header wdm.h (einschließlich Wdm.h, Ntddk.h, Ntifs.h)
Bibliothek NtosKrnl.lib
DLL NtosKrnl.exe
IRQL <= DISPATCH_LEVEL

Weitere Informationen

IoAllocateMdl

IoBuildPartialMdl