Função MmMapMdl (wdm.h)
Essa função mapeia páginas físicas descritas por uma MDL (lista de descritores de memória) para o espaço de endereço virtual do sistema.
Sintaxe
NTSTATUS MmMapMdl(
[in] PMDL MemoryDescriptorList,
[in] ULONG Protection,
[in] PMM_MDL_ROUTINE DriverRoutine,
[in] PVOID DriverContext
);
Parâmetros
[in] MemoryDescriptorList
Um ponteiro para um MDL válido.
[in] Protection
Um bit a bit de sinalizadores que indica a proteção a ser definida para as páginas. Os valores possíveis são PAGE_Xxx constantes definidas no Wdm.h.
[in] DriverRoutine
Um ponteiro para uma rotina de retorno de chamada fornecida pelo driver (MM_MDL_ROUTINE) que é invocada depois que o MDL é mapeado.
[in] DriverContext
Um ponteiro para um contexto definido pelo driver. A função de retorno de chamada do driver pode armazenar qualquer informação de status no contexto do driver e, em seguida, examinar o valor, quando o retorno de chamada é invocado.
Valor de retorno
Se a função de retorno de chamada apontada por driverRoutine foi invocada, essa função retornará STATUS_SUCCESS. A função retornará um valor NTSTATUS apropriado se o MDL não puder ser mapeado ou a função de retorno de chamada não puder ser invocada.
Observações
MmMapMdl mapeia o MDL (se ainda não estiver mapeado), invoca o retorno de chamada e libera o mapeamento (se um tiver sido criado). O chamador não precisa executar nenhuma limpeza.
Requisitos
Requisito | Valor |
---|---|
de cliente com suporte mínimo | Windows 10, versão 1709 |
servidor com suporte mínimo | Windows Server 2016 |
da Plataforma de Destino | Windows |
cabeçalho | wdm.h |
biblioteca | NtosKrnl.lib |
de DLL | NtosKrnl.exe (modo kernel) |
IRQL | <=DISPATCH_LEVEL |