ZwMapViewOfSection-Funktion (wdm.h)

Artikel
05/23/2024

Die ZwMapViewOfSection-Routine ordnet eine Ansicht eines Abschnitts dem virtuellen Adressraum eines Betreffprozesses zu.

Syntax

NTSYSAPI NTSTATUS ZwMapViewOfSection(
  [in]                HANDLE          SectionHandle,
  [in]                HANDLE          ProcessHandle,
  [in, out]           PVOID           *BaseAddress,
  [in]                ULONG_PTR       ZeroBits,
  [in]                SIZE_T          CommitSize,
  [in, out, optional] PLARGE_INTEGER  SectionOffset,
  [in, out]           PSIZE_T         ViewSize,
  [in]                SECTION_INHERIT InheritDisposition,
  [in]                ULONG           AllocationType,
  [in]                ULONG           Win32Protect
);

Parameter

[in] SectionHandle

Handle für ein Abschnittsobjekt. Dieses Handle wird durch einen erfolgreichen Aufruf von ZwCreateSection oder ZwOpenSection erstellt.

[in] ProcessHandle

Handle für das -Objekt, das den Prozess darstellt, dem die Ansicht zugeordnet werden soll. Verwenden Sie das Makro ZwCurrentProcess , um den aktuellen Prozess anzugeben. Das Handle muss mit PROCESS_VM_OPERATION Zugriff geöffnet worden sein.

[in, out] BaseAddress

Zeiger auf eine Variable, die die Basisadresse der Ansicht empfängt. Wenn der Wert dieses Parameters nicht NULL ist, wird die Ansicht ab der angegebenen virtuellen Adresse zugeordnet, gerundet auf die nächste Adressgrenze von 64 Kilobyte.

[in] ZeroBits

Gibt die Anzahl von Adressbits hoher Reihenfolge an, die in der Basisadresse der Abschnittsansicht null sein müssen. Der Wert dieses Parameters darf kleiner als 21 sein und wird nur verwendet, wenn BaseAddressNULL ist, d. h. wenn der Aufrufer dem System erlaubt, zu bestimmen, wo die Ansicht zugeordnet werden soll.

[in] CommitSize

Gibt die Größe des anfänglich committeten Bereichs der Ansicht in Bytes an. CommitSize ist nur für auf Seitendateien gesicherte Abschnitte sinnvoll und wird auf das nächste Vielfache PAGE_SIZE aufgerundet. (Für Abschnitte, in denen Dateien zugeordnet werden, werden sowohl die Daten als auch das Bild zum Zeitpunkt der Abschnittserstellung committet.)

[in, out, optional] SectionOffset

Ein Zeiger auf eine Variable, die den Offset in Bytes vom Anfang des Abschnitts bis zur Ansicht empfängt. Wenn dieser Zeiger nicht NULL ist, wird der Offset auf die nächste Größengrenze der Zuordnungsgranularität gerundet.

[in, out] ViewSize

Ein Zeiger auf eine SIZE_T Variable. Wenn der Anfangswert dieser Variablen null ist, ordnet ZwMapViewOfSection eine Ansicht des Abschnitts zu, der bei SectionOffset beginnt und bis zum Ende des Abschnitts fortgesetzt wird. Andernfalls gibt der Anfangswert die Größe der Ansicht in Bytes an. ZwMapViewOfSection rundet diesen Wert immer auf das nächste Vielfache von PAGE_SIZE auf, bevor die Ansicht zugeordnet wird.

Bei der Rückgabe empfängt der Wert die tatsächliche Größe der Ansicht in Byte.

[in] InheritDisposition

Gibt an, wie die Ansicht für untergeordnete Prozesse freigegeben werden soll. Mögliche Werte:

ViewShare

Die Ansicht wird allen untergeordneten Prozessen zugeordnet, die in Zukunft erstellt werden.

ViewUnmap

Die Ansicht wird nicht untergeordneten Prozessen zugeordnet.

Treiber sollten in der Regel ViewUnmap für diesen Parameter angeben.

[in] AllocationType

Gibt einen Satz von Flags an, der den Typ der Zuordnung beschreibt, die für den angegebenen Bereich von Seiten ausgeführt werden soll. Gültige Flags sind MEM_RESERVE, MEM_TOP_DOWN, MEM_LARGE_PAGES, MEM_DIFFERENT_IMAGE_BASE_OK und MEM_REPLACE_PLACEHOLDER. Obwohl MEM_COMMIT nicht zulässig ist, ist dies impliziert, es sei denn, MEM_RESERVE angegeben ist. Weitere Informationen zu den MEM_XXX-Flags finden Sie in der Beschreibung der Routinen VirtualAlloc und MapViewOfFile3 .

[in] Win32Protect

Gibt den Seitenschutz an, der auf die zugeordnete Ansicht angewendet werden soll.

Bei Abschnittsobjekten, die mit dem attribut SEC_IMAGE erstellt wurden, hat der Win32Protect-Parameter keine Auswirkung und kann auf einen beliebigen gültigen Wert wie PAGE_READONLY festgelegt werden.

Bei Abschnittsobjekten, die mit dem attribut SEC_IMAGE_NO_EXECUTE erstellt wurden, muss der Win32Protect-Wert auf PAGE_READONLY festgelegt werden.

Für Nicht-Image-Abschnitte muss der Wert des Win32Protect-Parameters mit dem Seitenschutz des Abschnitts kompatibel sein, der beim Aufruf von ZwCreateSection angegeben wurde.

ZwMapViewOfSection legt den Cachetyp der zugeordneten Seiten so fest, dass er dem Cachetyp entspricht, der beim Erstellen des Abschnittsobjekts angegeben wurde. Wenn z. B. ZwCreateSection mit dem flag SEC_NOCACHE aufgerufen wurde, ordnet ZwMapViewOfSection die nicht zwischengespeicherten Seiten zu, unabhängig davon, ob der Win32Protect-Parameter das flag PAGE_NOCACHE enthält oder nicht.

Rückgabewert

ZwMapViewOfSection gibt einen NTSTATUS-Wert zurück. Folgende Rückgabewerte sind möglich:

Rückgabecode	Beschreibung
STATUS_SUCCESS	Die Routine hat den angeforderten Vorgang erfolgreich ausgeführt.
STATUS_CONFLICTING_ADDRESSES	Der angegebene Adressbereich steht in Konflikt mit einem Bereich, der bereits reserviert ist.
STATUS_INVALID_PAGE_PROTECTION	Der für den Win32Protect-Parameter angegebene Wert ist ungültig.
STATUS_SECTION_PROTECTION	Der für den Win32Protect-Parameter angegebene Wert ist nicht mit dem Seitenschutz kompatibel, der beim Erstellen des Abschnitts angegeben wurde.

Hinweise

Mehrere verschiedene Ansichten eines Abschnitts können gleichzeitig dem virtuellen Adressraum eines oder mehrerer Prozesse zugeordnet werden.

Verwenden Sie ZwMapViewOfSection nicht, um einen Speicherbereich von \Device\PhysicalMemory dem Benutzermodus zuzuordnen, es sei denn, Ihr Treiber hat den Speicherbereich direkt über MmAllocatePagesForMdlEx oder eine andere Methode zugeordnet, die garantiert, dass keine andere Systemkomponente denselben Speicherbereich mit einem anderen MEMORY_CACHING_TYPE Wert zugeordnet hat.

Benutzeranwendungen können ab Windows Server 2003 mit Service Pack 1 (SP1) nicht direkt auf \Device\PhysicalMemory zugreifen und können nur darauf zugreifen, wenn der Treiber ein Handle an die Anwendung übergibt.

Weitere Informationen zu Abschnittsobjekten finden Sie unter Abschnittsobjekte und Sichten.

Wenn der Aufruf dieser Funktion im Benutzermodus erfolgt, sollten Sie den Namen "NtMapViewOfSection" anstelle von "ZwMapViewOfSection" verwenden.

Bei Aufrufen von Kernelmodustreibern können sich die NtXxx - und ZwXxx-Versionen einer Windows Native System Services-Routine anders verhalten, wie sie Eingabeparameter verarbeiten und interpretieren. Weitere Informationen zur Beziehung zwischen den Nt Xxx- und ZwXxx-Versionen einer Routine finden Sie unter Verwenden von Nt- und Zw-Versionen der systemeigenen Systemdienstroutinen.

Anforderungen

Anforderung	Wert
Zielplattform	Universell
Header	wdm.h (einschließlich Wdm.h, Ntddk.h, Ntifs.h)
Bibliothek	NtosKrnl.lib
DLL	NtosKrnl.exe
IRQL	PASSIVE_LEVEL
DDI-Complianceregeln	HwStorPortProhibitedDIs(storport), PowerIrpDDis(wdm)