LockPages
.gif "A hyphen indicates that the information in this topic is not relevant for this platform, or that the platform does not support the API that is listed.")
.gif "A checkmark indicates that the information in this topic is relevant for this platform, and that any API listed is also supported on this platform.")
9/8/2008
Essa função bloqueia a região especificada do espaço de endereço virtual do processo, garantindo que acessar subseqüente à região não provoca falha uma página na memória. Esta função pode ser chamado somente no modo kernel.
Syntax
BOOL LockPages(
LPVOID lpvAddress,
DWORD cbSize,
PDWORD pPFNs,
int fOptions
);
Parameters
- lpvAddress
[no] Iniciando endereço de uma região de páginas confirmadas; Isto é, seja bloqueada.
- cbSize
[no] Número de bytes para bloqueio.
pPFNs
[out] Matriz de página físico números quadro que representa o CPU-dependente físico endereços de páginas.Este parâmetro pode ser definido como NULL se o associado físico páginas da região bloqueada não importa para o chamador.
fOptions
[no] Sinalizador opção.A seguinte tabela mostra valores possíveis para esse parâmetro.
Valor Descrição LOCKFLAG_QUERY_ONLY
Consulte o físico para mapeamento de uma alocação memória virtual. Há páginas estão bloqueadas.
LOCKFLAG_READ
Acessar de leitura é exigido, as opposed to página presente mas PAGE_NOACCESS.
LOCKFLAG_WRITE
Gravar acessar é exigido. Isso significa que bloqueando exclui outros autores.
Return Value
TRUE indica sucesso. FALSE indica falha. Para informações de erro estendidas get, chamar GetLastError.
Remarks
Para determinar o real físico endereço, o valor retornado nos pPFNs Deve ser deslocados um número de bits para a esquerda. A contagem SHIFT pode ser encontrada no UserKInfo [KINX_PFN_SHIFT]. Deslocar os valores retornados para a esquerda, esse valor para o real get físico endereço.
O físico páginas são armazenadas em ordem crescente, mas não são garantidas ser contíguo.
LockPages tem um contagem de referência, isso se chama o mesmo segmento LockPages Duas vezes, o segundo chamar para UnlockPages desbloqueia as páginas.
Requirements
| Header | pkfuncs.h |
| Library | coredll.lib |
| Windows Embedded CE | Windows CE 2.10 and later |
See Also
Reference
Kernel Functions
UnlockPages
LoadDriver