MmMapMdl-Funktion (wdm.h)

Artikel
02/07/2025

Diese Funktion ordnet physische Seiten, die durch eine Speicherdeskriptorliste (MDL) beschrieben werden, dem virtuellen Adressraum des Systems zu.

Syntax

NTSTATUS MmMapMdl(
  [in] PMDL            MemoryDescriptorList,
  [in] ULONG           Protection,
  [in] PMM_MDL_ROUTINE DriverRoutine,
  [in] PVOID           DriverContext
);

Parameter

[in] MemoryDescriptorList

Ein Zeiger auf eine gültige MDL.

[in] Protection

Ein bitweiser Flags, der den für die Seiten festzulegenden Schutz angibt. Mögliche Werte sind PAGE_Xxx Konstanten, die in Wdm.h definiert sind.

[in] DriverRoutine

Ein Zeiger auf eine vom Treiber bereitgestellte Rückrufroutine (MM_MDL_ROUTINE), die aufgerufen wird, nachdem die MDL zugeordnet wurde.

[in] DriverContext

Ein Zeiger auf einen vom Treiber definierten Kontext. Die Rückruffunktion des Treibers kann alle Statusinformationen im Treiberkontext speichern und dann den Wert untersuchen, wenn der Rückruf aufgerufen wird.

Rückgabewert

Wenn die Rückruffunktion, auf die durch DriverRoutine verwiesen wurde, aufgerufen wurde, gibt diese Funktion STATUS_SUCCESS zurück. Die Funktion gibt einen entsprechenden NTSTATUS-Wert zurück, wenn die MDL nicht zugeordnet werden konnte oder die Rückruffunktion nicht aufgerufen werden konnte.

Bemerkungen

MmMapMdl die MDL zuordnet (sofern sie noch nicht zugeordnet ist), ruft den Rückruf auf und gibt dann die Zuordnung frei (wenn eine erstellt wurde). Der Aufrufer muss keine Bereinigung durchführen.

Anforderungen

Anforderung	Wert
mindestens unterstützte Client-	Windows 10, Version 1709
mindestens unterstützte Server-	Windows Server 2016
Zielplattform-	Fenster
Header-	wdm.h
Library	NtosKrnl.lib
DLL-	NtosKrnl.exe (Kernelmodus)
IRQL-	<=DISPATCH_LEVEL

Siehe auch

MM_MDL_ROUTINE

Freigeben über