Funzione ZwUnmapViewOfSection (wdm.h)

Articolo
03/08/2023

La routine ZwUnmapViewOfSection annulla il mapping di una visualizzazione di una sezione dallo spazio indirizzi virtuale di un processo soggetto.

Sintassi

NTSYSAPI NTSTATUS ZwUnmapViewOfSection(
  [in]           HANDLE ProcessHandle,
  [in, optional] PVOID  BaseAddress
);

Parametri

[in] ProcessHandle

Handle a un oggetto processo passato in precedenza a ZwMapViewOfSection.

[in, optional] BaseAddress

Puntatore all'indirizzo virtuale di base della visualizzazione da rimuovere dal mapping. Questo valore può essere qualsiasi indirizzo virtuale all'interno della visualizzazione.

Valore restituito

ZwUnmapViewOfSection restituisce un valore NTSTATUS. I valori restituiti possibili includono:

Codice restituito	Descrizione
STATUS_SUCCESS	La routine ha eseguito correttamente l'operazione richiesta.
STATUS_ACCESS_DENIED	Il chiamante non dispone dei diritti di accesso all'oggetto processo o all'indirizzo virtuale di base della visualizzazione.

Commenti

Questa routine annulla il mapping dell'intera visualizzazione della sezione che contiene BaseAddress dallo spazio indirizzi virtuale del processo specificato, anche se BaseAddress non punta all'inizio della visualizzazione.

Al ritorno da ZwUnmapViewOfSection, l'area dell'indirizzo virtuale occupata dalla visualizzazione non è più riservata ed è disponibile per eseguire il mapping di altre visualizzazioni o pagine private. Se la vista è stata anche l'ultimo riferimento alla sezione sottostante, tutte le pagine di cui è stato eseguito il commit nella sezione vengono decommesse e la sezione viene eliminata.

Se la chiamata a questa funzione si verifica in modalità utente, è necessario usare il nome "NtUnmapViewOfSection" anziché "ZwUnmapViewOfSection".

Per le chiamate da driver in modalità kernel, le versioni NtXxx e ZwXxx di una routine di Servizi di sistema nativi di Windows possono comportarsi in modo diverso nel modo in cui gestiscono e interpretano i parametri di input. Per altre informazioni sulla relazione tra le versioni NtXxx e ZwXxx di una routine, vedere Using Nt and Zw Versions of the Native System Services Routines .For more information about the Nt Xxx and Zw versions of the Native System Services Routines.

Requisiti

Requisito	Valore
Piattaforma di destinazione	Universale
Intestazione	wdm.h (include Wdm.h, Ntddk.h, Ntifs.h)
Libreria	NtosKrnl.lib
DLL	NtosKrnl.exe
IRQL	PASSIVE_LEVEL
Regole di conformità DDI	HwStorPortProhibitedDDIs(storport), PowerIrpDDis(wdm)

Vedi anche

Uso delle versioni Nt e Zw delle routine native di Servizi di sistema

ZwMapViewOfSection

ZwOpenSection

Condividi tramite