Função MmUnlockPagableImageSection (wdm.h)

A rotina MmUnlockPagableImageSection libera uma seção de código de driver ou dados de driver, anteriormente bloqueados no espaço do sistema com MmLockPagableCodeSection, MmLockPagableDataSection ou MmLockPagableSectionByHandle, para que a seção possa ser excluída novamente.

Sintaxe

void MmUnlockPagableImageSection(
  [in] PVOID ImageSectionHandle
);

Parâmetros

[in] ImageSectionHandle

Especifica o identificador retornado por uma chamada para MmLockPagableCodeSection ou MmLockPagableDataSection.

Valor retornado

Nenhum

Comentários

O identificador da seção pageable de um driver não deverá ser liberado se o driver tiver algum IRPs pendente em suas filas de dispositivo ou filas internas. Uma chamada para MmUnlockPagableImageSection restaura a capacidade de página de toda essa seção quando não há mais referências ao identificador para essa seção.

O gerenciador de memória mantém a contagem de referência no identificador de uma seção. Uma seção pageable só está disponível para ser paginada quando a contagem de referências for zero. Cada solicitação de bloqueio incrementa a contagem; cada solicitação de desbloqueio diminui a contagem. Um driver deve desbloquear uma seção quantas vezes bloquear uma seção para disponibilizar a seção a ser paginada.

Um identificador é sempre válido, independentemente da contagem. Se a contagem em um identificador for zero e uma chamada for feita para MmLockPagableSectionByHandle, a contagem será definida como uma e, se a seção tiver sido excluída, ela será paginada.

Na maioria dos casos, MmUnlockPagableImageSection é chamado antes da rotina de descarregamento de um driver. Ou seja, um driver com uma seção pageable provavelmente terá sua chamada de rotina DispatchClose e/ou DispatchShutdownmmUnlockPagableImageSection antes que sua rotina de descarregamento seja chamada. No entanto, deve-se tomar cuidado em drivers descarregados para liberar qualquer seção pageable antes que o próprio driver seja descarregado do sistema.

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

Requisitos

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

Confira também

MmLockPagableCodeSection

MmLockPagableDataSection

MmLockPagableSectionByHandle

MmPageEntireDriver

MmResetDriverPaging