Função MmProbeAndLockSelectedPages (wdm.h)
A rotina MmProbeAndLockSelectedPages investiga as páginas de memória virtual selecionadas, torna-as residentes e as bloqueia na memória.
Sintaxe
void MmProbeAndLockSelectedPages(
[in, out] PMDL MemoryDescriptorList,
[in] PFILE_SEGMENT_ELEMENT SegmentArray,
[in] KPROCESSOR_MODE AccessMode,
[in] LOCK_OPERATION Operation
);
Parâmetros
[in, out] MemoryDescriptorList
Um ponteiro para uma MDL (lista de descritores de memória) que especifica um buffer de memória virtual. Se a rotina bloquear com êxito as páginas na memória, o MDL será atualizado para descrever as páginas físicas subjacentes.
[in] SegmentArray
Um ponteiro para uma matriz de segmentos de buffer que contêm as páginas de memória virtual.
[in] AccessMode
Especifica o modo de acesso no qual investigar os argumentos, KernelMode ou UserMode.
[in] Operation
Especifica o tipo de operação para o qual o chamador deseja que os direitos de acesso são investigados e as páginas bloqueadas. Defina esse parâmetro como IoReadAccess, IoWriteAccess ou IoModifyAccess. IoReadAccess indica que o driver pode examinar o conteúdo do buffer, mas não pode alterar o conteúdo. IoWriteAccess e IoModifyAccess, que são equivalentes, indicam que o driver tem acesso de leitura e gravação ao buffer.
Retornar valor
Nenhum
Comentários
As chamadas para MmProbeAndLockSelectedPages devem ser colocadas em um bloco try/except . Se as páginas não derem suporte à operação especificada, a rotina gerará o STATUS_ACCESS_VIOLATION ou outras exceções. Para obter mais informações, consulte Tratamento de exceções.
Requisitos
| Requisito | Valor |
|---|---|
| Cliente mínimo com suporte | Disponível a partir do Windows 2000. |
| Plataforma de Destino | Universal |
| Cabeçalho | wdm.h |
| IRQL | <= APC_LEVEL |