Fonction MmProbeAndLockSelectedPages (wdm.h)

Article
02/29/2024

La routine MmProbeAndLockSelectedPages sonde les pages de mémoire virtuelle sélectionnées, les rend résidentes et les verrouille en mémoire.

Syntaxe

void MmProbeAndLockSelectedPages(
  [in, out] PMDL                  MemoryDescriptorList,
  [in]      PFILE_SEGMENT_ELEMENT SegmentArray,
  [in]      KPROCESSOR_MODE       AccessMode,
  [in]      LOCK_OPERATION        Operation
);

Paramètres

[in, out] MemoryDescriptorList

Pointeur vers une liste de descripteurs de mémoire (MDL) qui spécifie une mémoire tampon de mémoire virtuelle. Si la routine verrouille correctement les pages en mémoire, le MDL est mis à jour pour décrire les pages physiques sous-jacentes.

[in] SegmentArray

Pointeur vers un tableau de segments de mémoire tampon qui contiennent les pages de mémoire virtuelle.

[in] AccessMode

Spécifie le mode d’accès dans lequel sonder les arguments, KernelMode ou UserMode.

[in] Operation

Spécifie le type d’opération pour laquelle l’appelant souhaite que les droits d’accès soient sondés et que les pages soient verrouillées. Définissez ce paramètre sur IoReadAccess, IoWriteAccess ou IoModifyAccess. IoReadAccess indique que le pilote peut examiner le contenu de la mémoire tampon, mais ne peut pas modifier le contenu. IoWriteAccess et IoModifyAccess, qui sont équivalents, indiquent que le pilote dispose à la fois d’un accès en lecture et en écriture à la mémoire tampon.

Valeur de retour

None

Remarques

Les appels à MmProbeAndLockSelectedPages doivent être placés dans un bloc try/except . Si les pages ne prennent pas en charge l’opération spécifiée, la routine déclenche le STATUS_ACCESS_VIOLATION ou d’autres exceptions. Pour plus d’informations, consultez Gestion des exceptions.

Configuration requise

Condition requise	Valeur
Client minimal pris en charge	Disponible à partir de Windows 2000.
Plateforme cible	Universal
En-tête	wdm.h
IRQL	<= APC_LEVEL

Voir aussi

MmProbeAndLockPages

Partager via