Função MmLockPagableSectionByHandle (ntddk.h)

Artigo
02/27/2024

A rotina MmLockPagableSectionByHandle bloqueia uma seção de dados ou código paginável na memória do sistema incrementando a contagem de referência no identificador para a seção.

Sintaxe

void MmLockPagableSectionByHandle(
  [in] PVOID ImageSectionHandle
);

Parâmetros

[in] ImageSectionHandle

O identificador de uma seção de dados ou código paginável. O chamador obteve esse identificador de uma chamada anterior para a rotina MmLockPagableCodeSection ou MmLockPagableDataSection .

Retornar valor

Nenhum

Comentários

Inicialmente, um driver chama MmLockPagableCodeSection ou MmLockPagableDataSection para obter um identificador para uma seção de dados ou código paginável. Depois disso, o driver pode chamar MmLockPagableSectionByHandle e MmUnlockPagableImageSection para incrementar e diminuir a contagem de referência no identificador.

A chamada MmLockPagableCodeSection ou MmLockPagableDataSection bloqueia a seção paginável na memória do sistema, retorna um identificador para a seção e inicializa a contagem de referência no identificador para um. MmLockPagableSectionByHandle incrementa a contagem de referência em um, e MmUnlockPagableImageSection diminui a contagem de referência em um.

Se a contagem de referência no identificador for diferente de zero, a seção paginável será bloqueada. Se a contagem de referência for zero, a seção será desbloqueada.

O identificador para a seção paginável permanece válido desde que o driver permaneça carregado na memória. O driver pode usar o mesmo identificador para bloquear e desbloquear repetidamente a seção. Ou seja, o driver pode reutilizar um identificador cuja contagem de referência é zero. MmLockPagableSectionByHandle verifica se a seção referenciada é residente no espaço de endereço do chamador e, se estiver, simplesmente incrementa a contagem de referência na seção. Se a seção não for residente, as páginas MmLockPagableSectionByHandle na seção o bloquearão no espaço do sistema e definirão a contagem de referência como uma.

Para evitar o vazamento de memória do sistema, a contagem de referência no identificador deve ser zero quando o driver é descarregado da memória. Caso contrário, a seção paginável permanecerá bloqueada na memória do sistema após o descarregamento do driver.

Se o driver estiver se preparando para descarregar e a contagem de referência no identificador for diferente de zero, o driver deverá chamar MmUnlockPagableImageSection para diminuir a contagem para zero antes que o descarregamento ocorra.

Um driver não pode chamar MmLockPagableSectionByHandle para bloquear buffers de usuário passados em IRPs. Em vez disso , use MmProbeAndLockPages .

Para obter mais informações sobre o código e os dados de paginação, consulte Tornando os drivers pagináveis.

Requisitos

Requisito	Valor
Cliente mínimo com suporte	Disponível a partir do Windows 2000.
Plataforma de Destino	Universal
Cabeçalho	ntddk.h (inclua Ntddk.h)
Biblioteca	NtosKrnl.lib
DLL	NtosKrnl.exe
IRQL	<= APC_LEVEL
Regras de conformidade da DDI	HwStorPortProhibitedDDIs(storport), IrqlMmApcLte(wdm)