Funzione MmProbeAndLockSelectedPages (wdm.h)
La routine MmProbeAndLockSelectedPages esegue il probe delle pagine di memoria virtuale selezionate, le rende residenti e le blocca in memoria.
Sintassi
void MmProbeAndLockSelectedPages(
[in, out] PMDL MemoryDescriptorList,
[in] PFILE_SEGMENT_ELEMENT SegmentArray,
[in] KPROCESSOR_MODE AccessMode,
[in] LOCK_OPERATION Operation
);
Parametri
[in, out] MemoryDescriptorList
Puntatore a un elenco di descrittori di memoria (MDL) che specifica un buffer di memoria virtuale. Se la routine blocca correttamente le pagine in memoria, il file MDL viene aggiornato per descrivere le pagine fisiche sottostanti.
[in] SegmentArray
Puntatore a una matrice di segmenti di buffer che contengono le pagine di memoria virtuale.
[in] AccessMode
Specifica la modalità di accesso in cui eseguire il probe degli argomenti, KernelMode o UserMode.
[in] Operation
Specifica il tipo di operazione per cui il chiamante desidera che i diritti di accesso venga eseguito il probe e le pagine bloccate. Impostare questo parametro su IoReadAccess, IoWriteAccess o IoModifyAccess. IoReadAccess indica che il driver può esaminare il contenuto del buffer, ma non può modificare il contenuto. IoWriteAccess e IoModifyAccess, equivalenti, indicano che il driver ha accesso in lettura e scrittura al buffer.
Valore restituito
nessuno
Osservazioni
Le chiamate a MmProbeAndLockSelectedPages devono essere racchiuse in un blocco try/except . Se le pagine non supportano l'operazione specificata, la routine genera la STATUS_ACCESS_VIOLATION o altre eccezioni. Per altre informazioni, vedere Gestione delle eccezioni.
Requisiti
| Requisito | Valore |
|---|---|
| Client minimo supportato | Disponibile a partire da Windows 2000. |
| Piattaforma di destinazione | Universale |
| Intestazione | wdm.h |
| IRQL | <= APC_LEVEL |