Fonction MmUnlockPagableImageSection (wdm.h)

Article
08/08/2023

La routine MmUnlockPagableImageSection libère une section de code de pilote ou de données de pilote, précédemment verrouillée dans l’espace système avec MmLockPagableCodeSection, MmLockPagableDataSection ou MmLockPagableSectionByHandle, de sorte que la section peut être paginée à nouveau.

Syntaxe

void MmUnlockPagableImageSection(
  [in] PVOID ImageSectionHandle
);

Paramètres

[in] ImageSectionHandle

Spécifie le handle retourné par un appel à MmLockPagableCodeSection ou MmLockPagableDataSection.

Valeur de retour

None

Remarques

Le handle de la section paginable d’un pilote ne doit pas être libéré si le pilote a des IRP en suspens dans ses files d’attente de périphériques ou files d’attente internes. Un appel à MmUnlockPagableImageSection restaure la paginabilité de cette section entière lorsqu’il n’y a plus de références au handle pour cette section.

Le gestionnaire de mémoire conserve le nombre de références sur le handle dans une section. Une section paginable n’est disponible pour être paginée que lorsque le nombre de références est égal à zéro. Chaque demande de verrouillage incrémente le nombre ; chaque demande de déverrouillage décrémente le nombre. Un pilote doit déverrouiller une section autant de fois qu’il verrouille une section pour rendre la section disponible pour être paginée.

Un handle est toujours valide, quel que soit le nombre. Si le nombre sur un handle est égal à zéro et qu’un appel est effectué à MmLockPagableSectionByHandle, le nombre est défini sur un, et si la section a été paginée, elle est paginée.

Dans la plupart des cas, MmUnlockPagableImageSection est appelé avant la routine de déchargement d’un pilote. Autrement dit, un pilote avec une section paginable est susceptible d’avoir sa routine DispatchClose et/ou DispatchShutdown appeler MmUnlockPagableImageSection avant que sa routine de déchargement soit appelée. Toutefois, il convient de veiller à ce que les pilotes déchargés libèrent toute section paginable avant que le pilote lui-même ne soit déchargé du système.

Pour plus d’informations sur la pagination du code et des données, consultez Rendre les pilotes paginables.

Configuration requise

Condition requise	Valeur
Client minimal pris en charge	Disponible à partir de Windows 2000.
Plateforme cible	Universal
En-tête	wdm.h (include Wdm.h, Ntddk.h, Ntifs.h)
Bibliothèque	NtosKrnl.lib
DLL	NtosKrnl.exe
IRQL	<=APC_LEVEL
Règles de conformité DDI	HwStorPortProhibitedDDIs(storport), IrqlMmApcLte(wdm)