MmPageEntireDriver-Funktion (wdm.h)

Artikel
07.02.2025

Die MmPageEntireDriver Routine bewirkt, dass der gesamte Code und die Daten eines Treibers seitenfähig gemacht werden, wodurch die Attribute der verschiedenen Abschnitte außer Kraft gesetzt werden, aus denen das Treiberbild besteht.

Syntax

C++

PVOID MmPageEntireDriver(
  [in] PVOID AddressWithinSection
);

Parameter

[in] AddressWithinSection

Zeigen Sie auf eine virtuelle Adresse innerhalb des Treibers (z. B. die Adresse der DriverEntry Routine).

Rückgabewert

MmPageEntireDriver gibt einen Zeiger an den Anfang des Treiberimages im Arbeitsspeicher zurück.

Bemerkungen

Verwenden Sie diese Routine, um zu erzwingen, dass ein Treiber vollständig ausgelagert werden kann. Treiber, die MmPageEntireDriver aufrufen, dürfen keine InterruptService Routine (ISR) für Unterbrechungen registriert haben. Wenn der Interrupt auftritt, während der Treiber ausgelagert wird, gibt das System eine Fehlerüberprüfung aus.

Die Auswirkung eines Aufrufs an MmPageEntireDriver- kann rückgängig gemacht werden, indem MmResetDriverPagingaufgerufen wird.

Wenn der Treiber bereits vollständig ausgelagert werden kann, hat das Aufrufen MmPageEntireDriver keine Auswirkung. Weitere Informationen zum Auslagerungen eines gesamten Treibers finden Sie unter Erstellen von "Drivers Pageable".

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-	<= APC_LEVEL
DDI-Complianceregeln	HwStorPortProhibitedDIs(storport), IrqlMmApcLte(wdm)