IoFreeMdl-Funktion (wdm.h)
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 |