MmProbeAndLockSelectedPages, fonction (wdm.h)
La 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 lequel l’appelant souhaite que les droits d’accès soient sondés et les pages 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
Aucun
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 la STATUS_ACCESS_VIOLATION ou d’autres exceptions. Pour plus d’informations, consultez Gestion des exceptions.
Exigences
| Exigence | Valeur |
|---|---|
| client minimum pris en charge | Disponible à partir de Windows 2000. |
| plateforme cible | Universel |
| d’en-tête | wdm.h |
| IRQL | <= APC_LEVEL |