Funzione VirtualLock (memoryapi.h)
Blocca l'area specificata dello spazio indirizzi virtuale del processo nella memoria fisica, assicurando che l'accesso successivo all'area non incorra in un errore di pagina.
Sintassi
BOOL VirtualLock(
[in] LPVOID lpAddress,
[in] SIZE_T dwSize
);
Parametri
[in] lpAddress
Puntatore all'indirizzo di base dell'area delle pagine da bloccare.
[in] dwSize
Dimensioni dell'area da bloccare, in byte. L'area delle pagine interessate include tutte le pagine che contengono uno o più byte nell'intervallo dal parametro lpAddress a (lpAddress+dwSize). Ciò significa che un intervallo di 2 byte che stradding un limite di pagina causa il blocco di entrambe le pagine.
Valore restituito
Se la funzione ha esito positivo, il valore restituito è diverso da zero.
Se la funzione ha esito negativo, il valore restituito è zero. Per informazioni dettagliate sull'errore, chiamare GetLastError.
Commenti
È necessario eseguire il commit di tutte le pagine nell'area specificata. Impossibile bloccare la memoria protetta con PAGE_NOACCESS .
Il blocco delle pagine in memoria può ridurre le prestazioni del sistema riducendo la RAM disponibile e forzando il sistema a scambiare altre pagine critiche nel file di paging. Ogni versione di Windows ha un limite per il numero massimo di pagine che un processo può bloccare. Questo limite è intenzionalmente piccolo per evitare un grave degrado delle prestazioni. Le applicazioni che devono bloccare numeri maggiori di pagine devono prima chiamare la funzione SetProcessWorkingSetSize per aumentare le dimensioni minime e massime del set di lavoro. Il numero massimo di pagine che un processo può bloccare è uguale al numero di pagine nel set minimo di lavoro meno un sovraccarico ridotto.
Le pagine bloccate da un processo rimangono in memoria fisica fino a quando il processo li sblocca o termina. Queste pagine non devono essere scritte nel file di pagina mentre sono bloccate.
Per sbloccare un'area di pagine bloccate, usare la funzione VirtualUnlock . Le pagine bloccate vengono sbloccate automaticamente al termine del processo.
Questa funzione non è simile alla funzione GlobalLock o LocalLock in cui non incrementa un conteggio dei blocchi e converte un handle in un puntatore. Non esiste alcun conteggio dei blocchi per le pagine virtuali, quindi non sono mai necessarie più chiamate alla funzione VirtualUnlock per sbloccare un'area di pagine.
Esempio
Per un esempio, vedere Creazione di pagine guard.
Requisiti
| Client minimo supportato | Windows XP [app desktop | App UWP] |
| Server minimo supportato | Windows Server 2003 [app desktop | App UWP] |
| Piattaforma di destinazione | Windows |
| Intestazione | memoryapi.h (includono Windows.h, Memoryapi.h) |
| Libreria | onecore.lib |
| DLL | Kernel32.dll |