IoFreeMdl-Funktion (wdm.h)
Die IoFreeMdl Routine gibt eine vom Anrufer zugewiesene Speicherbeschreibungsliste (MDL) frei.
Syntax
void IoFreeMdl(
[in] PMDL Mdl
);
Parameter
[in] Mdl
Zeiger auf die zu veröffentlichende MDL.
Rückgabewert
Nichts
Bemerkungen
Wenn ein Treiber eine MDL zur Beschreibung eines Puffers zuweist, muss er die MDL explizit freigeben, wenn Vorgänge im Puffer ausgeführt werden.
Wenn es sich bei der MDL um eine partielle MDL handelt, IoFreeMdl alle Seiten aufheben, die der MDL zugeordnet wurden.
Wenn die physischen Seiten, die von der MDL beschrieben werden, gesperrt sind, muss der Treiber die Seiten entsperren, bevor die MDL freigegeben wird.
Diese Routine gibt nur die angegebene MDL frei. Alle MDLs, die mit dieser MDL verkettet sind, müssen explizit über zusätzliche Aufrufe dieser Routine freigegeben werden. Ein Codebeispiel zum Freigeben einer MDL-Kette finden Sie unter Verwenden von MDLs.
Anforderungen
| Anforderung | Wert |
|---|---|
| mindestens unterstützte Client- | Ab Windows 2000 verfügbar. |
| Zielplattform- | Universal |
| Header- | wdm.h (include Wdm.h, Ntddk.h, Ntifs.h) |
| Library | NtosKrnl.lib |
| DLL- | NtosKrnl.exe |
| IRQL- | <= DISPATCH_LEVEL |