Fonction ZwUnmapViewOfSection (wdm.h)

Article
02/29/2024

La routine ZwUnmapViewOfSection annule le mappage d’une vue d’une section à partir de l’espace d’adressage virtuel d’un processus d’objet.

Syntaxe

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

Paramètres

[in] ProcessHandle

Gérez un objet de processus qui a été précédemment passé à ZwMapViewOfSection.

[in, optional] BaseAddress

Pointeur vers l’adresse virtuelle de base de la vue pour annuler le mappage. Cette valeur peut être n’importe quelle adresse virtuelle dans la vue.

Valeur retournée

ZwUnmapViewOfSection retourne une valeur NTSTATUS. Les valeurs de retour possibles sont les suivantes :

Code de retour	Description
STATUS_SUCCESS	La routine a correctement effectué l’opération demandée.
STATUS_ACCESS_DENIED	L’appelant ne dispose pas de droits d’accès à l’objet de processus ou à l’adresse virtuelle de base de la vue.

Remarques

Cette routine annule le mappage de la vue entière de la section qui contient BaseAddress à partir de l’espace d’adressage virtuel du processus spécifié, même si BaseAddress ne pointe pas vers le début de l’affichage.

Au retour de ZwUnmapViewOfSection, la région d’adresse virtuelle occupée par la vue n’est plus réservée et est disponible pour mapper d’autres affichages ou pages privées. Si la vue était également la dernière référence à la section sous-jacente, toutes les pages validées de la section sont décompressées et la section est supprimée.

Si l’appel à cette fonction se produit en mode utilisateur, vous devez utiliser le nom « NtUnmapViewOfSection » au lieu de « ZwUnmapViewOfSection ».

Pour les appels à partir de pilotes en mode noyau, les versions NtXxx et ZwXxx d’une routine Windows Native System Services peuvent se comporter différemment dans la façon dont elles gèrent et interprètent les paramètres d’entrée. Pour plus d’informations sur la relation entre les versions NtXxx et ZwXxx d’une routine, consultez Utilisation des versions Nt et Zw des routines des services système natifs.

Configuration requise

Condition requise	Valeur
Plateforme cible	Universal
En-tête	wdm.h (inclure Wdm.h, Ntddk.h, Ntifs.h)
Bibliothèque	NtosKrnl.lib
DLL	NtosKrnl.exe
IRQL	PASSIVE_LEVEL
Règles de conformité DDI	HwStorPortProhibitedDDIs(storport),PowerIrpDDis(wdm)

Voir aussi

Utilisation des versions Nt et Zw des routines natives des services système natifs

ZwMapViewOfSection

ZwOpenSection

Partager via