ZwUnmapViewOfSection-Funktion (wdm.h)
Die ZwUnmapViewOfSection-Routine hebt die Zuordnung einer Ansicht eines Abschnitts aus dem virtuellen Adressraum eines Betreffprozesses auf.
Syntax
NTSYSAPI NTSTATUS ZwUnmapViewOfSection(
[in] HANDLE ProcessHandle,
[in, optional] PVOID BaseAddress
);
Parameter
[in] ProcessHandle
Handle an ein Prozessobjekt, das zuvor an ZwMapViewOfSection übergeben wurde.
[in, optional] BaseAddress
Zeiger auf die virtuelle Basisadresse der Ansicht, um die Zuordnung aufzuheben. Dieser Wert kann eine beliebige virtuelle Adresse innerhalb der Ansicht sein.
Rückgabewert
ZwUnmapViewOfSection gibt einen NTSTATUS-Wert zurück. Mögliche Rückgabewerte sind:
| Rückgabecode | Beschreibung |
|---|---|
| STATUS_SUCCESS | Die Routine hat den angeforderten Vorgang erfolgreich ausgeführt. |
| STATUS_ACCESS_DENIED | Der Aufrufer verfügt nicht über Zugriffsrechte für das Prozessobjekt oder die virtuelle Basisadresse der Ansicht. |
Hinweise
Diese Routine hebt die Zuordnung der gesamten Ansicht des Abschnitts, der BaseAddress enthält, aus dem virtuellen Adressraum des angegebenen Prozesses auf , auch wenn BaseAddress nicht auf den Anfang der Ansicht zeigt.
Bei der Rückkehr von ZwUnmapViewOfSection ist der von der Ansicht belegte virtuelle Adressbereich nicht mehr reserviert und steht zum Zuordnen anderer Ansichten oder privater Seiten zur Verfügung. Wenn die Ansicht auch der letzte Verweis auf den zugrunde liegenden Abschnitt war, werden alle committeten Seiten im Abschnitt entfernt, und der Abschnitt wird gelöscht.
Wenn der Aufruf dieser Funktion im Benutzermodus erfolgt, sollten Sie den Namen "NtUnmapViewOfSection" anstelle von "ZwUnmapViewOfSection" 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) |