MmMapMdl-Funktion (wdm.h)

Artikel
03/01/2024

Diese Funktion ordnet physische Seiten, die durch eine Speicherdeskriptorliste (MDL) beschrieben werden, dem virtuellen Systemadressraum 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

Eine Bitweise von Flags, die 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 status Informationen im Treiberkontext speichern und dann den Wert untersuchen, wenn der Rückruf aufgerufen wird.

Rückgabewert

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

Hinweise

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

Anforderungen

Anforderung	Wert
Unterstützte Mindestversion (Client)	Windows 10, Version 1709
Unterstützte Mindestversion (Server)	Windows Server 2016
Zielplattform	Windows
Kopfzeile	wdm.h
Bibliothek	NtosKrnl.lib
DLL	NtosKrnl.exe (Kernelmodus)
IRQL	<=DISPATCH_LEVEL

Weitere Informationen

MM_MDL_ROUTINE

Freigeben über