Função MmProbeAndLockSelectedPages (wdm.h)

  • Artigo

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

Confira também

MmProbeAndLockPages