Função VirtualLock (memoryapi.h)

Bloqueia a região especificada do espaço de endereço virtual do processo na memória física, garantindo que o acesso subsequente à região não incorrerá em uma falha de página.

Sintaxe

BOOL VirtualLock(
  [in] LPVOID lpAddress,
  [in] SIZE_T dwSize
);

Parâmetros

[in] lpAddress

Um ponteiro para o endereço base da região de páginas a ser bloqueada.

[in] dwSize

O tamanho da região a ser bloqueada, em bytes. A região das páginas afetadas inclui todas as páginas que contêm um ou mais bytes no intervalo do parâmetro lpAddress até (lpAddress+dwSize). Isso significa que um intervalo de 2 bytes que atravessa um limite de página faz com que ambas as páginas sejam bloqueadas.

Valor retornado

Se a função for bem-sucedida, o valor retornado será diferente de zero.

Se a função falhar, o valor retornado será zero. Para obter informações de erro estendidas, chame GetLastError.

Comentários

Todas as páginas na região especificada devem ser confirmadas. A memória protegida com PAGE_NOACCESS não pode ser bloqueada.

Bloquear páginas na memória pode prejudicar o desempenho do sistema reduzindo a RAM disponível e forçando o sistema a trocar outras páginas críticas pelo arquivo de paginação. Cada versão do Windows tem um limite no número máximo de páginas que um processo pode bloquear. Esse limite é intencionalmente pequeno para evitar uma degradação grave do desempenho. Os aplicativos que precisam bloquear um número maior de páginas devem primeiro chamar a função SetProcessWorkingSetSize para aumentar seus tamanhos mínimos e máximos do conjunto de trabalho. O número máximo de páginas que um processo pode bloquear é igual ao número de páginas em seu conjunto de trabalho mínimo menos uma pequena sobrecarga.

As páginas que um processo bloqueou permanecem na memória física até que o processo as desbloqueie ou termine. Essas páginas têm a garantia de não serem gravadas no arquivo de página enquanto estão bloqueadas.

Para desbloquear uma região de páginas bloqueadas, use a função VirtualUnlock . As páginas bloqueadas são desbloqueadas automaticamente quando o processo é encerrado.

Essa função não é como a função GlobalLock ou LocalLock , pois não incrementa uma contagem de bloqueios e converte um identificador em um ponteiro. Não há nenhuma contagem de bloqueios para páginas virtuais, portanto, várias chamadas para a função VirtualUnlock nunca são necessárias para desbloquear uma região de páginas.

Exemplos

Para obter um exemplo, consulte Criando páginas de proteção.

Requisitos

Confira também

Funções de gerenciamento da memória

SetProcessWorkingSetSize

Funções de memória virtual

VirtualUnlock