Condividi tramite


Funzione ZwUnmapViewOfSection (wdm.h)

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