Função MmMapLockedPagesWithReservedMapping (wdm.h)

Artigo
02/29/2024

A rotina MmMapLockedPagesWithReservedMapping mapeia todo ou parte de um intervalo de endereços que foi previamente reservado pela rotina MmAllocateMappingAddress .

Sintaxe

PVOID MmMapLockedPagesWithReservedMapping(
  [in] PVOID                                                    MappingAddress,
  [in] ULONG                                                    PoolTag,
  [in] PMDL                                                     MemoryDescriptorList,
  [in] __drv_strictTypeMatch(__drv_typeCond)MEMORY_CACHING_TYPE CacheType
);

Parâmetros

[in] MappingAddress

Ponteiro para o início do intervalo de memória virtual reservado. Esse deve ser um endereço retornado anteriormente por MmAllocateMappingAddress.

[in] PoolTag

Especifica a marca de pool para o buffer de memória reservado. Isso deve ser idêntico ao valor especificado no parâmetro PoolTag da chamada para MmAllocateMappingAddress que reservou o buffer.

[in] MemoryDescriptorList

Um ponteiro para o MDL que deve ser mapeado. Esse MDL deve descrever páginas físicas que estão bloqueadas. Um MDL bloqueado pode ser criado pela rotina MmProbeAndLockPages ou MmAllocatePagesForMdlEx .

[in] CacheType

Especifica o valor de MEMORY_CACHING_TYPE a ser usado para criar o mapeamento.

Retornar valor

MmMapLockedPagesWithReservedMapping retorna um ponteiro para o início da memória mapeada ou NULL se o sistema não puder mapear a memória. Essa rotina retornará NULL somente se houver um erro nos parâmetros de função (por exemplo, o endereço de mapeamento do driver não é grande o suficiente para abranger o MDL fornecido). Essa função destina-se a permitir que os drivers progridam, mesmo em cenários de poucos recursos.

Comentários

O chamador pode usar MmMapLockedPagesWithReservedMapping para mapear um subintervalo do intervalo de memória virtual reservado por MmAllocateMappingAddress da seguinte maneira:

Use IoAllocateMdl para alocar um MDL. O MDL retornado é criado usando o endereço inicial e o tamanho especificados do subintervalo do intervalo de memória virtual a ser mapeado.
Use MmProbeAndLockPages para bloquear as páginas físicas descritas pelo MDL obtido na etapa 1.
Use MmMapLockedPagesWithReservedMapping para realmente mapear a memória virtual para a memória física que foi bloqueada na etapa 2. Observe que o endereço virtual retornado por essa função inclui o deslocamento de bytes especificado pelo MDL. No entanto, o campo MappedSystemVa do MDL definido por essa função não inclui o deslocamento de bytes.
Depois que o chamador não precisar acessar a memória, ele removerá a memória com MmUnmapReservedMapping. O chamador pode mapear e desmapear o buffer de memória conforme necessário e deve desmapeá-lo antes de liberar o intervalo de mapeamento com MmFreeMappingAddress.

Observe que o parâmetro MappingAddress especifica o início do intervalo de memória anteriormente reservado pelo chamador, não o início do subrange de memória a ser mapeado. O chamador especifica o endereço inicial e o comprimento do buffer quando aloca o MDL com IoAllocateMdl. O buffer deve caber dentro do intervalo de memória reservado, mas pode ser um subconjunto estrito.

A rotina usará o parâmetro CacheType somente se as páginas descritas pelo MDL ainda não tiverem um tipo de cache associado a elas. No entanto, em quase todos os casos, as páginas já têm um tipo de cache associado e esse tipo de cache é usado pelo novo mapeamento. Uma exceção a essa regra é para páginas alocadas por MmAllocatePagesForMdl, que não têm um tipo de cache específico associado a elas. Para essas páginas, o parâmetro CacheType determina o tipo de cache do mapeamento.

Requisitos

Requisito	Valor
Cliente mínimo com suporte	Disponível no Windows XP e versões posteriores do Windows.
Plataforma de Destino	Universal
Cabeçalho	wdm.h (include Wdm.h, Ntddk.h, Ntifs.h)
Biblioteca	NtosKrnl.lib
DLL	NtosKrnl.exe
IRQL	<= DISPATCH_LEVEL
Regras de conformidade da DDI	HwStorPortProhibitedDDIs(storport)