Função MmProbeAndLockSelectedPages (wdm.h)

O MmProbeAndLockSelectedPages investiga as páginas de memória virtual selecionadas, as torna 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.

Valor de retorno

Nenhum

Observações

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á a STATUS_ACCESS_VIOLATION ou outras exceções. Para obter mais informações, consulte de exceções de tratamento de.

Requisitos

Consulte também

MmProbeAndLockPages