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

Vedi anche

MmProbeAndLockPages