Função MmLockPagableDataSection (wdm.h)

A rotina MmLockPagableDataSection bloqueia uma seção inteira dos dados do driver no espaço do sistema.

Sintaxe

PVOID MmLockPagableDataSection(
  [in] PVOID AddressWithinSection
);

Parâmetros

[in] AddressWithinSection

Especifica o endereço simbólico de um item de dados dentro da seção paginável.

Retornar valor

MmLockPagableDataSection retorna um valor opaco que identifica a seção. Esse valor deve ser passado posteriormente para MmLockPagableSectionByHandle ou para MmUnlockPagableImageSection.

Comentários

Os drivers podem usar essa rotina, MmLockPagableSectionByHandle e MmUnlockPagableImageSection para tornar seus dados privados normalmente pagináveis bloqueados na memória.

Os dados poderão ser bloqueados se:

• Normalmente, os dados são acessados em <= APC_LEVEL, mas talvez precisem ser acessados em níveis irql mais altos por curtos períodos.

• O driver usa os dados com pouca frequência e previsivelmente.

Por exemplo, os drivers para dispositivos de mixer usam seções pageable-data. Como o driver usa dados suficientes para fazer com que a criação de uma seção pageable-data valha a pena e o driver sabe quando os dados são necessários, esse driver usa MmLockPagableDataSection, MmLockPagableSectionByHandle e MmUnlockPagableImageSection para colocar uma seção de dados no espaço do sistema quando necessário e disponibilizá-la para ser paginada quando não necessário.

Uma única chamada para MmLockPagableDataSection faz com que toda a seção, contendo os dados referenciados, seja bloqueada no espaço do sistema.

É uma operação cara para bloquear uma seção. Se uma seção pageable-data for bloqueada em mais de um lugar por um driver, use MmLockPagableDataSection para a primeira solicitação. Faça solicitações de bloqueio subsequentes chamando MmLockPagableSectionByHandle, passando o identificador retornado por MmLockPagableDataSection. O bloqueio por identificador melhora significativamente o desempenho do driver. Uma seção bloqueada é desbloqueada chamando MmUnlockPagableImageSection.

O gerenciador de memória mantém uma contagem de referência na seção . Uma seção pageable-data só está disponível para ser paginada quando a contagem de referência é 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 garantir que essa seção esteja disponível para ser paginada quando a seção não for necessária. 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 um e, se a seção tiver sido paginada, ela será paginada.

Os dados em uma seção pageable-data são marcados por uma diretiva do compilador. Para criar uma seção de dados paginável, use #pragma data_seg ("PAGE"), no início do módulo de dados e #pragma data_seg () no final do módulo. O palavra-chave PAGE diferencia maiúsculas de minúsculas, ou seja, PAGE deve ser maiúscula.

Observe que também há um #pragma data_seg("INIT") que é usado para tornar os dados descartáveis após a inicialização do sistema. Exceto pelo uso de INIT em vez de PAGE, a sintaxe é a mesma. No entanto, o resultado não é; O uso da diretiva PAGE torna a seção de dados paginável. Quando a diretiva INIT é usada, os dados na seção são descartados assim que o driver retorna de sua rotina de entrada de driver ou sua rotina de reinicialização se o driver tiver um.

Para obter mais informações sobre 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	wdm.h (include Wdm.h, Ntddk.h, Ntifs.h)
Biblioteca	NtosKrnl.lib
DLL	NtosKrnl.exe
IRQL	<=APC_LEVEL
Regras de conformidade da DDI	HwStorPortProhibitedDDIs(storport), IrqlMmApcLte(wdm)

Confira também

MmLockPagableCodeSection

MmLockPagableSectionByHandle

MmPageEntireDriver

MmResetDriverPaging

MmUnlockPagableImageSection